From bf2415e2c110a321804478125503afbfa8f9e0f8 Mon Sep 17 00:00:00 2001 From: Quoc Kien Ngo <156245273+KNQuoc@users.noreply.github.com> Date: Tue, 19 Aug 2025 22:35:50 -0400 Subject: [PATCH 1/3] Fix Cedar documentation URL --- docs/mcp-integration/mcp-server.mdx | 28 ++++++++++++++++++++-------- 1 file changed, 20 insertions(+), 8 deletions(-) diff --git a/docs/mcp-integration/mcp-server.mdx b/docs/mcp-integration/mcp-server.mdx index 7ab10ccb..ce9cc60b 100644 --- a/docs/mcp-integration/mcp-server.mdx +++ b/docs/mcp-integration/mcp-server.mdx @@ -10,13 +10,13 @@ Open your Cursor settings file (`~/.cursor/settings.json`) and add: ```json { - "mcpServers": { - "cedar": { - "command": "npx", - "args": ["@cedar/mcp-server"], - "env": {} - } - } + "mcpServers": { + "cedar": { + "command": "npx", + "args": ["@cedar/mcp-server"], + "env": {} + } + } } ``` @@ -56,6 +56,7 @@ Ask the MCP server natural language questions: ## Common Usage Patterns ### Component Implementation + ``` "Help me implement a floating chat component with Cedar" "Add voice capabilities to my Cedar chat interface" @@ -64,6 +65,7 @@ Ask the MCP server natural language questions: ``` ### Documentation Queries + ``` "Show me Cedar chat component documentation" "How do I configure streaming in Cedar?" @@ -72,6 +74,7 @@ Ask the MCP server natural language questions: ``` ### Integration Tasks + ``` "Connect my Cedar frontend to a Mastra agent" "Set up voice streaming with WebSockets" @@ -82,13 +85,16 @@ Ask the MCP server natural language questions: ## Advanced Features ### Contextual Awareness + The MCP server understands: + - Your project structure and existing Cedar components - Current file context and imports - Project dependencies and configuration - Cedar best practices and patterns ### Specialized Modules + - **Voice Expert**: Audio streaming, permissions, WebSocket configuration - **Spells Expert**: Spell creation, activation patterns, gesture handling - **Mastra Expert**: Agent connections, workflow setup, backend integration @@ -97,18 +103,21 @@ The MCP server understands: ## Common Workflows ### Setting Up a New Project + 1. Initialize Cedar: `"Set up a new Cedar project with TypeScript"` 2. Add chat: `"Add Cedar chat components to my app"` 3. Configure backend: `"Connect to my Mastra agent backend"` 4. Add voice: `"Implement voice capabilities"` ### Building Features + 1. Start simple: `"Create a basic chat interface"` 2. Add interactivity: `"Add mention support to chat"` 3. Enhance UX: `"Implement message streaming"` 4. Add AI features: `"Create a questioning spell"` ### Debugging Issues + - `"Debug WebSocket connection problems"` - `"Fix streaming message display"` - `"Resolve spell activation conflicts"` @@ -133,16 +142,19 @@ The MCP server understands: ## Troubleshooting ### MCP Server Not Responding + - Verify configuration in Cursor settings - Check Node.js is accessible - Restart Cursor after changes ### Incorrect Suggestions + - Provide more project context - Specify Cedar version - Include relevant code snippets ### Performance Issues + - Clear Cursor cache - Check internet connection - Update MCP server version @@ -158,4 +170,4 @@ The MCP server understands: - [Cedar Discord Community](https://discord.gg/4AWawRjNdZ) - [GitHub Issues](https://github.com/CedarCopilot/cedar-OS/issues) -- [Cedar Documentation](https://docs.cedar.ai) \ No newline at end of file +- [Cedar Documentation](https://docs.cedarcopilor.com) From 56c6be2fac49065e813ac4b8cf8af51e6cedec34 Mon Sep 17 00:00:00 2001 From: Nethenoob <69742247+Nethenoob@users.noreply.github.com> Date: Mon, 25 Aug 2025 00:37:47 -0400 Subject: [PATCH 2/3] update to docs --- docs/mcp-integration/mcp-server.mdx | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/docs/mcp-integration/mcp-server.mdx b/docs/mcp-integration/mcp-server.mdx index 7ab10ccb..ae2598d5 100644 --- a/docs/mcp-integration/mcp-server.mdx +++ b/docs/mcp-integration/mcp-server.mdx @@ -11,10 +11,9 @@ Open your Cursor settings file (`~/.cursor/settings.json`) and add: ```json { "mcpServers": { - "cedar": { - "command": "npx", - "args": ["@cedar/mcp-server"], - "env": {} + "cedar-mcp": { + "url": "https://mcpwithcedar-production.up.railway.app/jsonrpc", + "description": "Cedar-OS Expert MCP Server" } } } @@ -158,4 +157,4 @@ The MCP server understands: - [Cedar Discord Community](https://discord.gg/4AWawRjNdZ) - [GitHub Issues](https://github.com/CedarCopilot/cedar-OS/issues) -- [Cedar Documentation](https://docs.cedar.ai) \ No newline at end of file +- [Cedar Documentation](https://docs.cedarcopilot.com) \ No newline at end of file From 8c40a004adf3cca23f0454bbe8051daf055e745c Mon Sep 17 00:00:00 2001 From: Quoc Kien Ngo <156245273+KNQuoc@users.noreply.github.com> Date: Wed, 24 Sep 2025 14:08:49 -0400 Subject: [PATCH 3/3] docs: update MCP server documentation to support Cursor, Claude Code, and Windsurf - Added specific installation instructions for each IDE - Updated Cursor to use JSON config - Added Claude Code CLI command for terminal installation - Added Windsurf with SSE endpoint configuration - Made references IDE-agnostic throughout the document - Updated prerequisites to list all compatible IDEs --- docs/mcp-integration/mcp-server.mdx | 66 ++++++++++++++++++++++------- 1 file changed, 50 insertions(+), 16 deletions(-) diff --git a/docs/mcp-integration/mcp-server.mdx b/docs/mcp-integration/mcp-server.mdx index ae2598d5..9abb2363 100644 --- a/docs/mcp-integration/mcp-server.mdx +++ b/docs/mcp-integration/mcp-server.mdx @@ -1,31 +1,53 @@ # Cedar MCP Server -The Cedar Model Context Protocol (MCP) server enables seamless integration between Cedar-OS and AI development environments like Cursor, providing intelligent assistance for building AI-native frontends. +The Cedar Model Context Protocol (MCP) server enables seamless integration between Cedar-OS and AI development environments like Cursor, Claude Code, and Windsurf, providing intelligent assistance for building AI-native frontends. ## Quick Start -### 1. Install in Cursor +### 1. Install in Your IDE +**For Cursor:** Open your Cursor settings file (`~/.cursor/settings.json`) and add: ```json { - "mcpServers": { - "cedar-mcp": { - "url": "https://mcpwithcedar-production.up.railway.app/jsonrpc", - "description": "Cedar-OS Expert MCP Server" - } - } + "mcpServers": { + "cedar-mcp": { + "url": "https://mcpwithcedar-production.up.railway.app/jsonrpc", + "description": "Cedar-OS Expert MCP Server" + } + } } ``` -### 2. Restart Cursor +**For Claude Code:** +Add the following into your terminal: -Close and reopen Cursor to activate the MCP server. +``` +claude mcp add --transport http cedar https://mcpwithcedar-production.up.railway.app/jsonrpc +``` + +**For Windsurf:** +Configure the MCP server in your Windsurf settings: + +```json +{ + "mcpServers": { + "cedar-mcp": { + "url": "https://mcpwithcedar-production.up.railway.app/sse", + "description": "Cedar-OS Expert MCP Server" + } + } +} +``` + +### 2. Restart Your IDE + +Close and reopen your IDE (Cursor, Claude Code, or Windsurf) to activate the MCP server. ### 3. Verify Installation -In any file, type a comment and use Cursor's AI assistant: +In any file, type a comment and use your IDE's AI assistant: ```javascript // Help me create a Cedar chat component @@ -55,6 +77,7 @@ Ask the MCP server natural language questions: ## Common Usage Patterns ### Component Implementation + ``` "Help me implement a floating chat component with Cedar" "Add voice capabilities to my Cedar chat interface" @@ -63,6 +86,7 @@ Ask the MCP server natural language questions: ``` ### Documentation Queries + ``` "Show me Cedar chat component documentation" "How do I configure streaming in Cedar?" @@ -71,6 +95,7 @@ Ask the MCP server natural language questions: ``` ### Integration Tasks + ``` "Connect my Cedar frontend to a Mastra agent" "Set up voice streaming with WebSockets" @@ -81,13 +106,16 @@ Ask the MCP server natural language questions: ## Advanced Features ### Contextual Awareness + The MCP server understands: + - Your project structure and existing Cedar components - Current file context and imports - Project dependencies and configuration - Cedar best practices and patterns ### Specialized Modules + - **Voice Expert**: Audio streaming, permissions, WebSocket configuration - **Spells Expert**: Spell creation, activation patterns, gesture handling - **Mastra Expert**: Agent connections, workflow setup, backend integration @@ -96,18 +124,21 @@ The MCP server understands: ## Common Workflows ### Setting Up a New Project + 1. Initialize Cedar: `"Set up a new Cedar project with TypeScript"` 2. Add chat: `"Add Cedar chat components to my app"` 3. Configure backend: `"Connect to my Mastra agent backend"` 4. Add voice: `"Implement voice capabilities"` ### Building Features + 1. Start simple: `"Create a basic chat interface"` 2. Add interactivity: `"Add mention support to chat"` 3. Enhance UX: `"Implement message streaming"` 4. Add AI features: `"Create a questioning spell"` ### Debugging Issues + - `"Debug WebSocket connection problems"` - `"Fix streaming message display"` - `"Resolve spell activation conflicts"` @@ -132,23 +163,26 @@ The MCP server understands: ## Troubleshooting ### MCP Server Not Responding -- Verify configuration in Cursor settings + +- Verify configuration in your IDE settings - Check Node.js is accessible -- Restart Cursor after changes +- Restart your IDE after changes ### Incorrect Suggestions + - Provide more project context - Specify Cedar version - Include relevant code snippets ### Performance Issues -- Clear Cursor cache + +- Clear your IDE cache - Check internet connection - Update MCP server version ## Prerequisites -- Cursor IDE (latest version) +- Compatible IDE: Cursor, Claude Code, or Windsurf (latest version) - Node.js 18+ installed - Basic TypeScript/React knowledge - Cedar-OS project or willingness to create one @@ -157,4 +191,4 @@ The MCP server understands: - [Cedar Discord Community](https://discord.gg/4AWawRjNdZ) - [GitHub Issues](https://github.com/CedarCopilot/cedar-OS/issues) -- [Cedar Documentation](https://docs.cedarcopilot.com) \ No newline at end of file +- [Cedar Documentation](https://docs.cedarcopilot.com)