Remote MCP Server On Cloudflare B9s

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

Cloudflare Workers上で動作するリモートMCPサーバーを構築し、OAuthログイン機能を統合しましょう！

🚀 クイックスタート

📦 インストール

# リポジトリをクローン
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 を使用して起動します。
• チェッカー（http://localhost:5173）で、転送タイプを 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が特定のツールを呼び出すよう要求することがあります。

🔧 デプロイ

Cloudflareへのデプロイ

1. Cloudflare Dashboardにログインします。
2. サイトを選択するか、新しいサイトを作成します。
3. 「Workers」>「Create a Script」を選択し、関連情報（名前、ファイルパスなど）を入力します。
4. 関連する設定（敏感情報へのアクセス許可など）を有効にすることを確認します。
5. スクリプトを保存してデプロイします。 これらの手順を完了すると、MCPサーバーがCloudflare上にホストされ、割り当てられたドメインからアクセスできるようになります。

リモートクライアントからデプロイ済みのMCPサーバーを呼び出す

1. デプロイが成功したら、curl コマンドを使用してテストできます。

curl -X POST http://your-domain/some-endpoint

2. 具体的な実装に応じて、リクエストパラメータとパスを調整します。 実際に使用する前に、ドキュメントとログを確認して、すべてが正常に動作していることを確認してください。

🔧 トラブルシューティング

• 問題：MCPサーバーに接続できない
  • ネットワークが正常に動作していることを確認します。
  • Cloudflare Workersが正しくデプロイされていることを確認します。
  • Cloudflareコンソールにエラーログがないか確認します。
• 問題：ログインに失敗する
  • OAuth設定が正しく、キーが有効であることを確認します。
  • 認証プロセスの各ステップを確認し、漏れがないことを確認します。
• 問題：ツールが一覧表示されないまたは呼び出せない
  • MCPサーバーのAPIドキュメントを確認し、エンドポイントとパラメータが正しいことを確認します。
  • curl コマンドを使用して関連するインターフェースを手動でテストします。

以上の手順に従えば、リモートMCPサーバーの構築、接続、使用がスムーズに行え、問題が発生した場合も迅速に特定して解決できます。MCPプロトコルの探索を楽しんでください！