From 4db51599f74109cd4877788389557528a7f79869 Mon Sep 17 00:00:00 2001 From: R3D347HR4Y Date: Sun, 30 Nov 2025 01:20:51 +0100 Subject: [PATCH 1/3] docs: added AI Integration section to use parse-mcp to help LLMs and AI Agents interact with Parse Server --- AI_INTEGRATION.md | 139 ++++++++++++++++++++++++++++++++++++++++++++++ CONTRIBUTING.md | 1 + README.md | 30 ++++++++++ 3 files changed, 170 insertions(+) create mode 100644 AI_INTEGRATION.md diff --git a/AI_INTEGRATION.md b/AI_INTEGRATION.md new file mode 100644 index 0000000000..70030579aa --- /dev/null +++ b/AI_INTEGRATION.md @@ -0,0 +1,139 @@ +# AI Integration for Parse Server + +This document describes how AI agents and LLMs can interact with Parse Server databases. + +## Parse MCP Server + +[Parse MCP Server](https://github.com/R3D347HR4Y/parse-mcp) is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that enables AI assistants to interact with Parse Server instances through natural language. + +[![Docker Hub](https://img.shields.io/docker/v/purpleshow/parse-mcp-server?label=Docker%20Hub&logo=docker&sort=semver)](https://hub.docker.com/r/purpleshow/parse-mcp-server) +[![GitHub](https://img.shields.io/github/stars/R3D347HR4Y/parse-mcp?style=social)](https://github.com/R3D347HR4Y/parse-mcp) + +### Features + +| Category | Capabilities | +|----------|-------------| +| **Schema Exploration** | Get all schemas, inspect class structure, understand field types | +| **Data Querying** | Full Parse query syntax, pagination, sorting, pointer includes | +| **Relations** | Query and manage Pointer and Relation fields | +| **CRUD Operations** | Create, read, update, delete objects with safety prompts | +| **Batch Operations** | Bulk create, update, delete (max 50 per batch) | +| **Users & Roles** | Query users, list roles, get role members | +| **Cloud Code** | Execute Cloud Code functions | +| **Aggregation** | MongoDB-style aggregation pipelines | +| **Troubleshooting** | Validate pointers, find orphaned references, class statistics | +| **Configuration** | Read and update Parse Config | + +### Installation + +#### Docker (Recommended) + +```bash +docker pull purpleshow/parse-mcp-server:latest + +docker run -d -p 3000:3000 \ + -e PARSE_SERVER_URL="http://localhost:1337/parse" \ + -e PARSE_APP_ID="YOUR_APP_ID" \ + -e PARSE_MASTER_KEY="YOUR_MASTER_KEY" \ + purpleshow/parse-mcp-server:latest +``` + +#### npm + +```bash +npm install -g parse-mcp-server +``` + +### IDE Configuration + +#### Cursor + +Add to `.cursor/mcp.json`: + +```json +{ + "mcpServers": { + "parse": { + "command": "docker", + "args": [ + "run", "-i", "--rm", + "-e", "MCP_TRANSPORT=stdio", + "-e", "PARSE_SERVER_URL=http://localhost:1337/parse", + "-e", "PARSE_APP_ID=YOUR_APP_ID", + "-e", "PARSE_MASTER_KEY=YOUR_MASTER_KEY", + "purpleshow/parse-mcp-server:latest" + ] + } + } +} +``` + +#### Claude Desktop + +Add to `claude_desktop_config.json`: + +```json +{ + "mcpServers": { + "parse": { + "command": "docker", + "args": [ + "run", "-i", "--rm", + "-e", "MCP_TRANSPORT=stdio", + "-e", "PARSE_SERVER_URL=http://localhost:1337/parse", + "-e", "PARSE_APP_ID=YOUR_APP_ID", + "-e", "PARSE_MASTER_KEY=YOUR_MASTER_KEY", + "purpleshow/parse-mcp-server:latest" + ] + } + } +} +``` + +### Environment Variables + +| Variable | Required | Description | +|----------|----------|-------------| +| `PARSE_SERVER_URL` | ✅ | Parse Server URL (e.g., `http://localhost:1337/parse`) | +| `PARSE_APP_ID` | ✅ | Your Parse Application ID | +| `PARSE_MASTER_KEY` | ⚠️ | Master Key for admin operations | +| `PARSE_JS_KEY` | ❌ | JavaScript Key (optional) | +| `MCP_TRANSPORT` | ❌ | `http` (default) or `stdio` | +| `MCP_PORT` | ❌ | HTTP port (default: 3000) | + +### Safety + +The MCP server is designed with safety in mind: + +- **Permission Prompts**: All data modification tools include warnings and suggest asking for user permission +- **Destructive Warnings**: Delete operations are clearly marked as dangerous +- **Sample-First Approach**: Encourages getting sample data before writing complex queries +- **Schema Awareness**: Suggests exploring schemas to understand data structure + +### Links + +- **GitHub**: https://github.com/R3D347HR4Y/parse-mcp +- **Docker Hub**: https://hub.docker.com/r/purpleshow/parse-mcp-server +- **npm**: https://www.npmjs.com/package/parse-mcp-server + +## For AI Agents + +If you are an AI agent exploring this repository: + +1. **To interact with a Parse Server database**, use the Parse MCP Server tools +2. **Before querying**, use `get_all_schemas` to understand the database structure +3. **Before complex queries**, use `get_sample_objects` to see actual data formats +4. **Before modifying data**, always ask the user for permission +5. **For troubleshooting**, use `validate_pointer` and `find_orphaned_pointers` + +### Recommended Workflow + +``` +1. check_connection → Verify Parse Server is accessible +2. get_all_schemas → Understand database structure +3. get_sample_objects → See real data examples for each class +4. query_class → Query with appropriate filters +5. [ask permission] → Before any write operations +6. create/update/delete → Modify data with user consent +``` + diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 30050f87a6..1972f04796 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -185,6 +185,7 @@ First of all, we appreciate your contribution. In rare cases, where we consider * [Visual Studio Code](https://code.visualstudio.com), the popular IDE. * [Jasmine Test Explorer](https://marketplace.visualstudio.com/items?itemName=hbenl.vscode-jasmine-test-adapter), a very practical test exploration plugin which let you run, debug and see the test results inline. +* [Parse MCP Server](https://github.com/R3D347HR4Y/parse-mcp), for AI-assisted development with tools like Cursor or Claude. See [AI_INTEGRATION.md](AI_INTEGRATION.md) for setup. ### Setting up your local machine diff --git a/README.md b/README.md index ad51487019..9688c5c579 100644 --- a/README.md +++ b/README.md @@ -89,6 +89,7 @@ A big *thank you* 🙏 to our [sponsors](#sponsors) and [backers](#backers) who - [Using automatically generated operations](#using-automatically-generated-operations) - [Customizing your GraphQL Schema](#customizing-your-graphql-schema) - [Learning more](#learning-more) +- [AI Integration](#ai-integration) - [Contributing](#contributing) - [Contributors](#contributors) - [Sponsors](#sponsors) @@ -1087,6 +1088,35 @@ You also have a very powerful tool inside your GraphQL Playground. Please look a Additionally, the [GraphQL Learn Section](https://graphql.org/learn/) is a very good source to learn more about the power of the GraphQL language. +# AI Integration + +Parse Server can be integrated with AI agents using the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). This allows AI assistants like Claude, Cursor, and other MCP-compatible tools to directly interact with your Parse Server database. + +## Parse MCP Server + +[Parse MCP Server](https://github.com/R3D347HR4Y/parse-mcp) provides AI agents with tools to: + +- 🔍 Explore database schemas and class structures +- 📊 Query objects with full Parse query syntax +- 🔗 Navigate Pointer and Relation fields +- ✏️ Create, update, and delete objects (with safety prompts) +- ☁️ Execute Cloud Code functions +- 📈 Run aggregation pipelines +- 🛠️ Troubleshoot data issues + +### Quick Start + +```bash +# Using Docker +docker run -d -p 3000:3000 \ + -e PARSE_SERVER_URL="http://localhost:1337/parse" \ + -e PARSE_APP_ID="YOUR_APP_ID" \ + -e PARSE_MASTER_KEY="YOUR_MASTER_KEY" \ + purpleshow/parse-mcp-server:latest +``` + +For IDE integration (Cursor, Claude Desktop), see the [Parse MCP Server documentation](https://github.com/R3D347HR4Y/parse-mcp#readme). + # Contributing Please see the [Contributing Guide](CONTRIBUTING.md). From bdeb59adb57cb1014c25e69f31a29c491808bd1d Mon Sep 17 00:00:00 2001 From: R3D347HR4Y Date: Sun, 30 Nov 2025 21:12:30 +0100 Subject: [PATCH 2/3] Update AI_INTEGRATION.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Signed-off-by: R3D347HR4Y --- AI_INTEGRATION.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/AI_INTEGRATION.md b/AI_INTEGRATION.md index 70030579aa..4b2e644201 100644 --- a/AI_INTEGRATION.md +++ b/AI_INTEGRATION.md @@ -112,9 +112,9 @@ The MCP server is designed with safety in mind: ### Links -- **GitHub**: https://github.com/R3D347HR4Y/parse-mcp -- **Docker Hub**: https://hub.docker.com/r/purpleshow/parse-mcp-server -- **npm**: https://www.npmjs.com/package/parse-mcp-server +- **GitHub**: +- **Docker Hub**: +- **npm**: ## For AI Agents From 29d8dc25a34e3a7dbb39e116017126a6a02ea7b2 Mon Sep 17 00:00:00 2001 From: R3D347HR4Y Date: Sun, 30 Nov 2025 21:12:53 +0100 Subject: [PATCH 3/3] Update AI_INTEGRATION.md Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com> Signed-off-by: R3D347HR4Y --- AI_INTEGRATION.md | 8 -------- 1 file changed, 8 deletions(-) diff --git a/AI_INTEGRATION.md b/AI_INTEGRATION.md index 4b2e644201..b2320d87cb 100644 --- a/AI_INTEGRATION.md +++ b/AI_INTEGRATION.md @@ -128,12 +128,4 @@ If you are an AI agent exploring this repository: ### Recommended Workflow -``` -1. check_connection → Verify Parse Server is accessible -2. get_all_schemas → Understand database structure -3. get_sample_objects → See real data examples for each class -4. query_class → Query with appropriate filters -5. [ask permission] → Before any write operations -6. create/update/delete → Modify data with user consent -```