From 6a716596ffd887293143a3b0df3e0931999de1eb Mon Sep 17 00:00:00 2001 From: William Lyon Date: Tue, 19 Aug 2025 13:38:56 -0600 Subject: [PATCH 1/5] add guide on using Hypermode docs MCP server --- docs.json | 2 +- hypermode-docs-mcp.mdx | 319 +++++++++++++++++++++++++++++++++++++++++ 2 files changed, 320 insertions(+), 1 deletion(-) create mode 100644 hypermode-docs-mcp.mdx diff --git a/docs.json b/docs.json index 322fa434..4db14137 100644 --- a/docs.json +++ b/docs.json @@ -200,7 +200,7 @@ }, { "group": "Resources", - "pages": ["security", "community-and-support"] + "pages": ["security", "community-and-support", "hypermode-docs-mcp"] } ] }, diff --git a/hypermode-docs-mcp.mdx b/hypermode-docs-mcp.mdx new file mode 100644 index 00000000..4eee4ac3 --- /dev/null +++ b/hypermode-docs-mcp.mdx @@ -0,0 +1,319 @@ +--- +title: "Hypermode Documentation MCP Server" +description: + "Learn how to use the Hypermode documentation MCP server to search + documentation and get help with Dgraph DQL queries" +sidebarTitle: "Docs MCP Server" +--- + +The Hypermode docs MCP (Model Context Protocol) server provides AI assistants +with direct access to search across the Hypermode documentation. This enables +more accurate and contextual assistance when working with Hypermode features, +Dgraph DQL queries, and development workflows. + +The MCP server is available as a remote MCP at `https://docs.hypermode.com/mcp`. + +## What's the Hypermode docs MCP server? + +The Hypermode docs MCP server is a specialized tool that allows AI assistants to +search and retrieve information from the Hypermode documentation in real-time. +It acts as a bridge between your AI assistant and the comprehensive Hypermode +knowledge base, ensuring you get the most up-to-date and relevant information. + +## Available tools + +### Search + +Search across the Hypermode documentation to find relevant information, code +examples, API references, and guides. + +**Parameters:** + +- `query` (string, required): The search query to execute across the + documentation + +**Returns:** + +An array of search results, each containing: + +- `title` (string): The title of the documentation page +- `content` (string): A brief description of the content +- `url` (string): Direct link to the documentation page +- `snippet` (string): Relevant text snippet from the documentation + +**Example tool call:** + +```json +{ + "name": "search", + "arguments": { + "query": "DQL query examples" + } +} +``` + +**Example response:** + +```json +{ + "results": [ + { + "title": "DQL Query Examples", + "content": "Learn how to write DQL queries with filtering and range operations...", + "url": "https://docs.hypermode.com/dgraph/dql/query", + "snippet": "Use the @filter directive with ge() and le() functions to find users within age ranges..." + } + ] +} +``` + +**Use this tool when you need to:** + +- Answer questions about Hypermode features +- Find specific documentation or guides +- Understand how features work +- Locate implementation details +- Get help with Dgraph DQL queries + +## Setup Instructions + +### Claude desktop + +1. Open Claude desktop +2. Go to **Settings** → **MCP Servers** +3. Click **Add Server** +4. Enter the following details: + - **Name**: `Hypermode docs` + - **URL**: `https://docs.hypermode.com/mcp` +5. Click **Save** +6. Restart Claude desktop + +### VS code + +1. Install the **MCP Client** extension from the VS code marketplace +2. Open Command Palette (`Cmd/Ctrl + Shift + P`) +3. Type "MCP: Add Server" and select it +4. Enter the server details: + - **Name**: `Hypermode docs` + - **URL**: `https://docs.hypermode.com/mcp` +5. The MCP server will be available in your AI assistant interactions + +### Cursor + +1. Open Cursor +2. Navigate to **Settings** → **AI** → **MCP Servers** +3. Click **Add Server** +4. Configure the server: + - **Name**: `Hypermode docs` + - **Endpoint**: `https://docs.hypermode.com/mcp` +5. Save and restart Cursor + +## Tool Call Examples + +Here are actual examples of what the Hypermode Docs MCP server tool calls and +responses look like: + +### Example 1: Searching for Dgraph DQL Examples + +**User Query**: "How do I write a DQL query to find all users with a specific +age range?" + +**MCP Search**: The assistant can search the Hypermode docs for DQL examples, +finding relevant documentation about: + +- Basic DQL query syntax +- Filtering and range queries +- User data models +- Specific examples from tutorials + +**Result**: The assistant provides a contextual answer with: + +- Relevant DQL query examples +- Links to specific documentation pages +- Additional context about Dgraph query patterns + +**MCP Tool Call**: + +```json +{ + "name": "search", + "arguments": { + "query": "DQL query find users age range filtering" + } +} +``` + +**MCP Response**: + +```json +{ + "results": [ + { + "title": "DQL Query Examples", + "content": "Learn how to write DQL queries with filtering and range operations...", + "url": "https://docs.hypermode.com/dgraph/dql/query", + "snippet": "Use the @filter directive with ge() and le() functions to find users within age ranges..." + }, + { + "title": "Basic DQL Operations", + "content": "Master the fundamentals of DQL query syntax...", + "url": "https://docs.hypermode.com/dgraph/dql/basic-operations", + "snippet": "Filtering with @filter allows you to narrow down results based on specific conditions..." + } + ] +} +``` + +### Example 2: Finding Hypermode Agent Connection Guides + +**User Query**: "How do I connect my agent to Stripe?" + +**MCP Search**: The assistant searches for Stripe connection documentation, +finding: + +- Step-by-step connection guides +- Required configuration details +- Example agent configurations +- Troubleshooting tips + +**Result**: The assistant delivers comprehensive setup instructions with direct +links to relevant documentation sections. + +**MCP Tool Call**: + +```json +{ + "name": "search", + "arguments": { + "query": "Stripe agent connection setup guide" + } +} +``` + +**MCP Response**: + +```json +{ + "results": [ + { + "title": "Stripe Connection Guide", + "content": "Step-by-step instructions for connecting your Hypermode agent to Stripe...", + "url": "https://docs.hypermode.com/agents/connections/stripe", + "snippet": "Add your Stripe API keys and configure webhook endpoints for your agent..." + }, + { + "title": "Available Connections", + "content": "Overview of all supported payment and commerce connections...", + "url": "https://docs.hypermode.com/agents/available-connections", + "snippet": "Stripe is fully supported with payment processing and customer management capabilities..." + } + ] +} +``` + +### Example 3: Python Dgraph Connection Syntax + +**User Query**: "What's the syntax to create a connection to Hypermode graphs +using the dgraph:// connection string in Python?" + +**MCP Search**: The assistant searches for Python Dgraph connection +documentation, finding: + +- Python SDK examples and tutorials +- Connection string syntax and format +- Hypermode graph connection guides +- Code samples for dgraph:// protocol + +**Result**: The assistant provides Python code examples with connection syntax +and links to relevant documentation. + +**MCP Tool Call**: + +```json +{ + "name": "search", + "arguments": { + "query": "Python dgraph connection string dgraph:// syntax" + } +} +``` + +**MCP Response**: + +```json +{ + "results": [ + { + "title": "Python SDK Documentation", + "content": "Learn how to connect to Dgraph from Python applications...", + "url": "https://docs.hypermode.com/dgraph/sdks/python", + "snippet": "Use the dgraph:// protocol to connect to Hypermode graphs with Python client libraries..." + }, + { + "title": "Graph Connection Guide", + "content": "Step-by-step instructions for connecting to Hypermode graphs...", + "url": "https://docs.hypermode.com/graphs/connect", + "snippet": "Python connection examples using dgraph:// connection strings for Hypermode graphs..." + } + ] +} +``` + +## Benefits of Using the MCP Server + +1. **Real-time Information**: Always access the latest documentation +2. **Contextual Results**: Get relevant information based on your specific query +3. **Direct Links**: Navigate directly to the source documentation +4. **Comprehensive Coverage**: Search across all Hypermode resources +5. **AI-Optimized**: Designed specifically for AI assistant interactions + +## Troubleshooting + +### Common Issues + +**Server Connection Failed** + +- Verify the URL: `https://docs.hypermode.com/mcp` +- Check your internet connection +- Ensure the MCP client supports HTTPS connections + +**Search Not Working** + +- Restart your MCP client application +- Verify the server is properly configured +- Check if the server requires authentication (currently none required) + +**No Results Found** + +- Try different search terms +- Use more specific queries +- Check if the documentation covers your topic + +### Getting Help + +If you encounter issues with the MCP server: + +1. Verify your configuration matches the setup instructions +2. Check the MCP client's error logs +3. Ensure you're using a supported MCP client +4. Contact Hypermode support if issues persist + +## Advanced Usage + +### Optimizing Searches + +- Use specific technical terms (e.g., "DQL aggregation" instead of "how to + count") +- Include feature names (e.g., "Hypermode agents" instead of "agents") +- Reference specific error messages or code snippets + +### Integration with Development Workflow + +- Use the MCP server during code reviews +- Get instant help with Dgraph queries +- Find examples for specific use cases +- Access troubleshooting guides in real-time + +The Hypermode Docs MCP server transforms your AI assistant into a knowledgeable +Hypermode expert, providing instant access to comprehensive documentation and +helping you build better applications with confidence. From 07d19d5e29aa2eb9682f9a6e7127325449bce670 Mon Sep 17 00:00:00 2001 From: William Lyon Date: Tue, 19 Aug 2025 13:42:04 -0600 Subject: [PATCH 2/5] style and format --- hypermode-docs-mcp.mdx | 48 +++++++++++++++++++++--------------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/hypermode-docs-mcp.mdx b/hypermode-docs-mcp.mdx index 4eee4ac3..042f34f4 100644 --- a/hypermode-docs-mcp.mdx +++ b/hypermode-docs-mcp.mdx @@ -108,17 +108,17 @@ An array of search results, each containing: - **Endpoint**: `https://docs.hypermode.com/mcp` 5. Save and restart Cursor -## Tool Call Examples +## Tool call examples Here are actual examples of what the Hypermode Docs MCP server tool calls and responses look like: ### Example 1: Searching for Dgraph DQL Examples -**User Query**: "How do I write a DQL query to find all users with a specific -age range?" +**User Query**: "How to write a DQL query to find all users with a specific age +range?" -**MCP Search**: The assistant can search the Hypermode docs for DQL examples, +**MCP Search** The assistant can search the Hypermode docs for DQL examples, finding relevant documentation about: - Basic DQL query syntax @@ -126,7 +126,7 @@ finding relevant documentation about: - User data models - Specific examples from tutorials -**Result**: The assistant provides a contextual answer with: +**Result** The assistant provides a contextual answer with: - Relevant DQL query examples - Links to specific documentation pages @@ -164,11 +164,11 @@ finding relevant documentation about: } ``` -### Example 2: Finding Hypermode Agent Connection Guides +### Example 2: Finding Hypermode agent connection guides -**User Query**: "How do I connect my agent to Stripe?" +**User Query**: "How to connect an agent to Stripe?" -**MCP Search**: The assistant searches for Stripe connection documentation, +**MCP Search** The assistant searches for Stripe connection documentation, finding: - Step-by-step connection guides @@ -176,7 +176,7 @@ finding: - Example agent configurations - Troubleshooting tips -**Result**: The assistant delivers comprehensive setup instructions with direct +**Result** The assistant delivers comprehensive setup instructions with direct links to relevant documentation sections. **MCP Tool Call**: @@ -211,12 +211,12 @@ links to relevant documentation sections. } ``` -### Example 3: Python Dgraph Connection Syntax +### Example 3: Python Dgraph connection syntax **User Query**: "What's the syntax to create a connection to Hypermode graphs using the dgraph:// connection string in Python?" -**MCP Search**: The assistant searches for Python Dgraph connection +**MCP Search** The assistant searches for Python Dgraph connection documentation, finding: - Python SDK examples and tutorials @@ -224,7 +224,7 @@ documentation, finding: - Hypermode graph connection guides - Code samples for dgraph:// protocol -**Result**: The assistant provides Python code examples with connection syntax +**Result** The assistant provides Python code examples with connection syntax and links to relevant documentation. **MCP Tool Call**: @@ -259,7 +259,7 @@ and links to relevant documentation. } ``` -## Benefits of Using the MCP Server +## Benefits of using the MCP server 1. **Real-time Information**: Always access the latest documentation 2. **Contextual Results**: Get relevant information based on your specific query @@ -271,25 +271,25 @@ and links to relevant documentation. ### Common Issues -**Server Connection Failed** +#### Server connection failed - Verify the URL: `https://docs.hypermode.com/mcp` - Check your internet connection - Ensure the MCP client supports HTTPS connections -**Search Not Working** +#### Search not working -- Restart your MCP client application +- Restart your MCP client app - Verify the server is properly configured - Check if the server requires authentication (currently none required) -**No Results Found** +#### No results found - Try different search terms - Use more specific queries - Check if the documentation covers your topic -### Getting Help +### Getting help If you encounter issues with the MCP server: @@ -298,16 +298,16 @@ If you encounter issues with the MCP server: 3. Ensure you're using a supported MCP client 4. Contact Hypermode support if issues persist -## Advanced Usage +## Advanced usage -### Optimizing Searches +### Optimizing searches -- Use specific technical terms (e.g., "DQL aggregation" instead of "how to - count") -- Include feature names (e.g., "Hypermode agents" instead of "agents") +- Use specific technical terms (for example, "DQL aggregation" instead of "how + to count") +- Include feature names (for example, "Hypermode agents" instead of "agents") - Reference specific error messages or code snippets -### Integration with Development Workflow +### Integration with development workflow - Use the MCP server during code reviews - Get instant help with Dgraph queries From 588b05cbed343087db4cc4c59193c9ebd2a3548d Mon Sep 17 00:00:00 2001 From: William Lyon Date: Tue, 19 Aug 2025 21:02:53 -0600 Subject: [PATCH 3/5] Update hypermode-docs-mcp.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- hypermode-docs-mcp.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hypermode-docs-mcp.mdx b/hypermode-docs-mcp.mdx index 042f34f4..21920ae3 100644 --- a/hypermode-docs-mcp.mdx +++ b/hypermode-docs-mcp.mdx @@ -90,7 +90,7 @@ An array of search results, each containing: ### VS code -1. Install the **MCP Client** extension from the VS code marketplace +1. Install the **MCP Client** extension from the VS Code marketplace 2. Open Command Palette (`Cmd/Ctrl + Shift + P`) 3. Type "MCP: Add Server" and select it 4. Enter the server details: From d4c8766eafbbec26a76281077062b1c35cbe8ba7 Mon Sep 17 00:00:00 2001 From: William Lyon Date: Tue, 19 Aug 2025 21:03:10 -0600 Subject: [PATCH 4/5] Update hypermode-docs-mcp.mdx Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- hypermode-docs-mcp.mdx | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/hypermode-docs-mcp.mdx b/hypermode-docs-mcp.mdx index 21920ae3..74b019cd 100644 --- a/hypermode-docs-mcp.mdx +++ b/hypermode-docs-mcp.mdx @@ -86,7 +86,16 @@ An array of search results, each containing: - **Name**: `Hypermode docs` - **URL**: `https://docs.hypermode.com/mcp` 5. Click **Save** -6. Restart Claude desktop +### Claude Desktop + +1. Open Claude Desktop +2. Go to **Settings** → **MCP Servers** +3. Click **Add Server** +4. Enter the following details: + - **Name**: `Hypermode docs` + - **URL**: `https://docs.hypermode.com/mcp` +5. Click **Save** +6. Restart Claude Desktop ### VS code From b609e76a758bdc571e6ce4d1f66337dd419defc0 Mon Sep 17 00:00:00 2001 From: William Lyon Date: Tue, 19 Aug 2025 21:07:45 -0600 Subject: [PATCH 5/5] style formatting --- hypermode-docs-mcp.mdx | 11 +---------- styles/config/vocabularies/general/accept.txt | 2 ++ 2 files changed, 3 insertions(+), 10 deletions(-) diff --git a/hypermode-docs-mcp.mdx b/hypermode-docs-mcp.mdx index 74b019cd..23a51400 100644 --- a/hypermode-docs-mcp.mdx +++ b/hypermode-docs-mcp.mdx @@ -77,15 +77,6 @@ An array of search results, each containing: ## Setup Instructions -### Claude desktop - -1. Open Claude desktop -2. Go to **Settings** → **MCP Servers** -3. Click **Add Server** -4. Enter the following details: - - **Name**: `Hypermode docs` - - **URL**: `https://docs.hypermode.com/mcp` -5. Click **Save** ### Claude Desktop 1. Open Claude Desktop @@ -97,7 +88,7 @@ An array of search results, each containing: 5. Click **Save** 6. Restart Claude Desktop -### VS code +### VS Code 1. Install the **MCP Client** extension from the VS Code marketplace 2. Open Command Palette (`Cmd/Ctrl + Shift + P`) diff --git a/styles/config/vocabularies/general/accept.txt b/styles/config/vocabularies/general/accept.txt index ba0491ee..9cc649a0 100644 --- a/styles/config/vocabularies/general/accept.txt +++ b/styles/config/vocabularies/general/accept.txt @@ -23,6 +23,7 @@ CRM Crunchbase [Cc]ryptocurrency [Cc]ypher +Claude Desktop datetime [Dd]eserialize Dgraph @@ -170,6 +171,7 @@ subgraph tablet UID|UIDs [Uu]psert|[Uu]pserts +VS Code [Zz]ero # Badger terms