{"id":28769337,"url":"https://github.com/jongan69/remote-mcp-server","last_synced_at":"2025-10-04T22:49:21.047Z","repository":{"id":288694435,"uuid":"968930545","full_name":"jongan69/remote-mcp-server","owner":"jongan69","description":null,"archived":false,"fork":false,"pushed_at":"2025-05-01T17:01:29.000Z","size":2024,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-17T13:13:31.863Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jongan69.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-19T02:31:36.000Z","updated_at":"2025-04-19T02:31:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"e2790c47-7037-49ef-8534-efe4d023b417","html_url":"https://github.com/jongan69/remote-mcp-server","commit_stats":null,"previous_names":["jongan69/remote-mcp-server"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jongan69/remote-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Fremote-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Fremote-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Fremote-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Fremote-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jongan69","download_url":"https://codeload.github.com/jongan69/remote-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jongan69%2Fremote-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278386114,"owners_count":25978109,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-04T02:00:05.491Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-17T13:03:50.667Z","updated_at":"2025-10-04T22:49:21.042Z","avatar_url":"https://github.com/jongan69.png","language":"TypeScript","funding_links":[],"categories":["Cloud Services"],"sub_categories":[],"readme":"# Remote MCP Server on Cloudflare\n\nLet's get a remote MCP server up-and-running on Cloudflare Workers complete with OAuth login!\n\n## Develop locally\n\n```bash\n# clone the repository\ngit clone git@github.com:cloudflare/ai.git\n\n# install dependencies\ncd ai\nnpm install\n\n# run locally\nnpx nx dev remote-mcp-server\n```\n\nYou should be able to open [`http://localhost:8787/`](http://localhost:8787/) in your browser\n\n## Connect the MCP inspector to your server\n\nTo explore your new MCP api, you can use the [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector).\n\n- Start it with `npx @modelcontextprotocol/inspector`\n- [Within the inspector](http://localhost:5173), switch the Transport Type to `SSE` and enter `http://localhost:8787/sse` as the URL of the MCP server to connect to, and click \"Connect\"\n- You will navigate to a (mock) user/password login screen. Input any email and pass to login.\n- You should be redirected back to the MCP Inspector and you can now list and call any defined tools!\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"img/mcp-inspector-sse-config.png\" alt=\"MCP Inspector with the above config\" width=\"600\"/\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"img/mcp-inspector-successful-tool-call.png\" alt=\"MCP Inspector with after a tool call\" width=\"600\"/\u003e\n\u003c/div\u003e\n\n## Connect Claude Desktop to your local MCP server\n\nThe MCP inspector is great, but we really want to connect this to Claude! Follow [Anthropic's Quickstart](https://modelcontextprotocol.io/quickstart/user) and within Claude Desktop go to Settings \u003e Developer \u003e Edit Config to find your configuration file.\n\nOpen the file in your text editor and replace it with this configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"math\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"http://localhost:8787/sse\"\n      ]\n    }\n  }\n}\n```\n\nThis will run a local proxy and let Claude talk to your MCP server over HTTP\n\nWhen you open Claude a browser window should open and allow you to login. You should see the tools available in the bottom right. Given the right prompt Claude should ask to call the tool.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"img/available-tools.png\" alt=\"Clicking on the hammer icon shows a list of available tools\" width=\"600\"/\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"img/claude-does-math-the-fancy-way.png\" alt=\"Claude answers the prompt 'I seem to have lost my calculator and have run out of fingers. Could you use the math tool to add 23 and 19?' by invoking the MCP add tool\" width=\"600\"/\u003e\n\u003c/div\u003e\n\n## Deploy to Cloudflare\n\n1. `npx wrangler kv namespace create OAUTH_KV`\n2. Follow the guidance to add the kv namespace ID to `wrangler.jsonc`\n3. `npm run deploy`\n\n## Call your newly deployed remote MCP server from a remote MCP client\n\nJust like you did above in \"Develop locally\", run the MCP inspector:\n\n`npx @modelcontextprotocol/inspector@latest`\n\nThen enter the `workers.dev` URL (ex: `worker-name.account-name.workers.dev/sse`) of your Worker in the inspector as the URL of the MCP server to connect to, and click \"Connect\".\n\nYou've now connected to your MCP server from a remote MCP client.\n\n## Connect Claude Desktop to your remote MCP server\n\nUpdate the Claude configuration file to point to your `workers.dev` URL (ex: `worker-name.account-name.workers.dev/sse`) and restart Claude \n\n```json\n{\n  \"mcpServers\": {\n    \"math\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"mcp-remote\",\n        \"https://worker-name.account-name.workers.dev/sse\"\n      ]\n    }\n  }\n}\n```\n\n## Debugging\n\nShould anything go wrong it can be helpful to restart Claude, or to try connecting directly to your\nMCP server on the command line with the following command.\n\n```bash\nnpx mcp-remote http://localhost:8787/sse\n```\n\nIn some rare cases it may help to clear the files added to `~/.mcp-auth`\n\n```bash\nrm -rf ~/.mcp-auth\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjongan69%2Fremote-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjongan69%2Fremote-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjongan69%2Fremote-mcp-server/lists"}