No description
Find a file
2025-03-24 12:26:07 -07:00
src Add VPN warning 2025-03-24 12:08:33 -07:00
.gitignore Ported v0.0.4 from mcp-remote-examples 2025-03-20 11:11:45 +11:00
.prettierignore format 2025-03-24 10:48:46 +00:00
.prettierrc Ported v0.0.4 from mcp-remote-examples 2025-03-20 11:11:45 +11:00
LICENSE Ported v0.0.4 from mcp-remote-examples 2025-03-20 11:11:45 +11:00
package.json Add VPN warning 2025-03-24 12:08:33 -07:00
pnpm-lock.yaml Update pnpm-lock.yaml 2025-03-24 14:19:41 +00:00
README.md Add warning about older versions of Node 2025-03-24 12:26:07 -07:00
tsconfig.json fix types and pass build 2025-03-24 09:49:44 +00:00

mcp-remote

Connect an MCP Client that only supports local (stdio) servers to a Remote MCP Server, with auth support:

Note: this is a working proof-of-concept but should be considered experimental

E.g: Claude Desktop or Windsurf

{
  "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": ["mcp-remote", "https://remote.mcp.server/sse"]
    }
  }
}

Cursor:

image

Debugging

Check your Node version

Make sure that the version of Node you have installed is 16 or higher.

Restart Claude

When modifying claude_desktop_config.json it can helpful to completely restart Claude

VPN Certs

You may run into issues if you are behind a VPN, you can try setting the NODE_EXTRA_CA_CERTS environment variable to point to the CA certificate file. If using claude_desktop_config.json, this might look like:

{
 "mcpServers": {
    "remote-example": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://remote.mcp.server/sse"
      ],
      "env": {
        "NODE_EXTRA_CA_CERTS": "{your CA certificate file path}.pem"
      }
    }
  }
}