My MCP Server Example

🚀 Cloudflare上でのリモートMCPサーバーの構築

Cloudflare Workers上でOAuthログイン機能を備えたリモートMCPサーバーを起動して利用しましょう！

🚀 クイックスタート

ローカル開発

# リポジトリをクローンする
git clone git@github.com:cloudflare/ai.git

# 依存関係をインストールする
cd ai
npm install

# ローカルで実行する
npx nx dev remote-mcp-server

ブラウザで http://localhost:8787/ を開くことができるはずです。

MCPチェッカーをサーバーに接続する

新しいMCP APIを探索するには、モデルコンテキストプロトコル（MCP）チェッカー を使用できます。

• 以下のコマンドでチェッカーを起動します： npx @modelcontextprotocol/inspector
• チェッカー内で、転送タイプを SSE に切り替え、URLフィールドに http://localhost:8787/sse を入力して、「接続」をクリックします。
• （模擬の）ユーザーログイン画面に入ります。任意のメールアドレスとパスワードを入力してログインします。
• ログインに成功すると、MCPチェッカーにリダイレクトされ、定義されたツールを一覧表示して呼び出すことができます！

Claude DesktopをローカルMCPサーバーに接続する

MCPチェッカーは便利ですが、実際にはClaudeと接続したいです！Anthropicのクイックスタートガイド に従って、Claude Desktopの設定 > 開発者 > 設定ファイルの編集を選択し、設定ファイルを見つけます。 このファイルを開き、以下の内容で置き換えます：

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:8787/sse"
      ]
    }
  }
}

これにより、ClaudeがHTTPを介してMCPサーバーと通信できるようになります。 Claudeを開くと、ブラウザウィンドウにログイン画面が表示されます。利用可能なツールのリストが右下に表示されるはずです。 指示に従って適切なプロンプトを入力すると、ClaudeがMCPサーバー上のツールを呼び出します。

Cloudflareへのデプロイ

1. npx wrangler kv namespace create OAUTH_KV
2. 指示に従って、KV名前空間IDを wrangler.jsonc に追加します。
3. npm run deploy

リモートMCPクライアントから新しくデプロイされたリモートMCPサーバーを呼び出す

「ローカル開発」のセクションと同じように、MCPチェッカーを実行します： npx @modelcontextprotocol/inspector@latest そして、チェッカー内でCloudflare WorkerのURL（例：worker-name.account-name.workers.dev/sse）を入力し、「接続」をクリックします。 これで、MCPサーバーをリモートMCPクライアントに接続することができました。

Claude DesktopをリモートMCPサーバーに接続する

Claude Desktopの設定ファイルで、URLを新しいCloudflare WorkerのURLに置き換えます：

{
  "mcpServers": {
    "math": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-worker-name.your-account-id.workers.dev/sse"
      ]
    }
  }
}

ファイルを保存すると、ClaudeがHTTPを介してCloudflare Workerと通信します。

デバッグの提案

問題が発生した場合は、以下を確認してください：

1. MCPサーバーが実行中であることを確認します。
2. ネットワーク接続が正常であることを確認します。
3. コンソールにエラーメッセージが表示されていないか確認します。

これで、Cloudflare Workers上でMCPサーバーを正常に実行して利用することができます！