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.

Related MCP server: Remote MCP Server on Cloudflare

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