From 2cce763c77a0f34e39ae47586a9150153d9da31a Mon Sep 17 00:00:00 2001 From: Jeremy Morrell Date: Mon, 24 Mar 2025 18:24:38 -0700 Subject: [PATCH 1/2] Add more detailed instructions to README --- README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 63 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 7207790..b0b07c3 100644 --- a/README.md +++ b/README.md @@ -16,22 +16,77 @@ That's where `mcp-remote` comes in. As soon as your chosen MCP client supports r ## Usage -E.g: Claude Desktop or Windsurf +### Claude Desktop + +[Official Docs](https://modelcontextprotocol.io/quickstart/user) + +In order to add an MCP server to Claude Desktop you need to edit the configuration file located at: + +macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` +Windows: `%APPDATA%\Claude\claude_desktop_config.json` + +If it does not exist yet, [you may need to enable it under Settings > Developer](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server). ```json { "mcpServers": { "remote-example": { "command": "npx", - "args": ["mcp-remote", "https://remote.mcp.server/sse"] + "args": [ + "-y", + "mcp-remote", + "https://remote.mcp.server/sse" + ] } } } ``` -Cursor: +Restart Claude Desktop to pick up the changes in the configuration file. +Upon restarting, you should see a hammer icon in the bottom right corner +of the input box. -![image](https://github.com/user-attachments/assets/14338bfa-a779-4e8a-a477-71f72cc5d99d) +### Cursor + +[Official Docs](https://docs.cursor.com/context/model-context-protocol) + +Add the following configuration to `~/.cursor/mcp.json`: + +```json +{ + "mcpServers": { + "remote-example": { + "command": "npx", + "args": [ + "-y", + "mcp-remote", + "https://remote.mcp.server/sse" + ] + } + } +} +``` + +### Windsurf + +[Official Docs](https://docs.codeium.com/windsurf/mcp) + +Add the following configuration to `~/.codeium/windsurf/mcp_config.json`: + +```json +{ + "mcpServers": { + "remote-example": { + "command": "npx", + "args": [ + "-y", + "mcp-remote", + "https://remote.mcp.server/sse" + ] + } + } +} +``` ## Building Remote MCP Servers @@ -54,7 +109,10 @@ Know of more resources you'd like to share? Please add them to this Readme and s ### Check your Node version -Make sure that the version of Node you have installed is [16 or higher](https://modelcontextprotocol.io/quickstart/server). +Make sure that the version of Node you have installed is [16 or +higher](https://modelcontextprotocol.io/quickstart/server). Claude +Desktop will use your system version of Node, even if you have a newer +version installed elsewhere. ### Restart Claude From 88d9909ebc4d36b07d9c9133520b6d4f0fd1b5ae Mon Sep 17 00:00:00 2001 From: Jeremy Morrell Date: Mon, 24 Mar 2025 18:25:54 -0700 Subject: [PATCH 2/2] add a space --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index b0b07c3..7acaa85 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,7 @@ That's where `mcp-remote` comes in. As soon as your chosen MCP client supports r In order to add an MCP server to Claude Desktop you need to edit the configuration file located at: macOS: `~/Library/Application Support/Claude/claude_desktop_config.json` + Windows: `%APPDATA%\Claude\claude_desktop_config.json` If it does not exist yet, [you may need to enable it under Settings > Developer](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server).