Remote-MCP-Server auf Cloudflare

Lassen Sie uns einen Remote-MCP-Server auf Cloudflare Workers zum Laufen bringen, komplett mit OAuth-Anmeldung!

Lokal entwickeln

# clone the repository
git clone git@github.com:cloudflare/ai.git

# install dependencies
cd ai
npm install

# run locally
npx nx dev remote-mcp-server-bearer-auth

Sie sollten http://localhost:8787/ in Ihrem Browser öffnen können.

Verbinden Sie den MCP-Inspektor mit Ihrem Server

Um Ihre neue MCP-API zu erkunden, können Sie den MCP Inspector verwenden.

Starten Sie es mit npx @modelcontextprotocol/inspector
Ändern Sie im Inspektor den Transporttyp in SSE und geben Sie http://localhost:8787/sse als URL des MCP-Servers ein, mit dem eine Verbindung hergestellt werden soll.
Fügen Sie ein Bearer-Token hinzu und klicken Sie auf „Verbinden“.
Klicken Sie auf „Tools auflisten“.
Führen Sie das Tool „getToken“ aus, das den Autorisierungsheader zurückgeben sollte, den Sie im Inspektor festgelegt haben.

Verbinden Sie Claude Desktop mit Ihrem lokalen MCP-Server

{
  "mcpServers": {
    "remote-mcp-server-bearer-auth": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ]
    },
    "env": {
      "AUTH_TOKEN": "..."
    }
  }
}

Bereitstellung auf Cloudflare

npm run deploy

Rufen Sie Ihren neu bereitgestellten Remote-MCP-Server von einem Remote-MCP-Client aus auf

Führen Sie den MCP-Inspektor aus, genau wie Sie es oben unter „Lokal entwickeln“ getan haben:

npx @modelcontextprotocol/inspector@latest

Geben Sie dann die workers.dev -URL (z. B. worker-name.account-name.workers.dev/sse ) Ihres Workers im Inspector als URL des MCP-Servers ein, mit dem eine Verbindung hergestellt werden soll, und klicken Sie auf „Verbinden“.

Sie haben nun von einem Remote-MCP-Client aus eine Verbindung zu Ihrem MCP-Server hergestellt. Sie können wie oben beschrieben ein Bearer-Token übergeben.

Debuggen

Sollte etwas schiefgehen, kann es hilfreich sein, Claude neu zu starten oder zu versuchen, mit dem folgenden Befehl über die Befehlszeile eine direkte Verbindung zu Ihrem MCP-Server herzustellen.

npx mcp-remote http://localhost:8787/sse

In einigen seltenen Fällen kann es hilfreich sein, die zu ~/.mcp-auth hinzugefügten Dateien zu löschen

rm -rf ~/.mcp-auth

Remote MCP Server on Cloudflare