My MCP Worker

🚀 Cloudflare Workersを使用したMCPサーバーの構築

モデルコンテキストプロトコル（MCP）を使って、AIエージェントとサービス間のやり取りを可能にするサーバーを構築します。Cloudflare Workersを利用することで、強力で拡張性の高いソリューションを提供します。

🚀 クイックスタート

前提条件

始める前に、以下のものが必要です。

• Cloudflareアカウント
• Node.jsがインストールされていること
• Wrangler CLIがインストールされていること (npm install -g wrangler)

手順1：新しいCloudflare Workerの作成

まず、新しいCloudflare Workerプロジェクトを初期化します。

npx create-cloudflare@latest my-mcp-worker
cd my-mcp-worker

次に、以下のコマンドでCloudflareアカウントを認証します。

wrangler login

手順2：Wranglerの設定

wrangler.toml ファイルを更新して、正しいアカウント情報を含めます。

name = "my-mcp-worker"
main = "src/index.ts"
compatibility_date = "2025-03-03"
account_id = "your-account-id"

📦 インストール

MCPサポートを有効にするために、workers-mcp パッケージをインストールします。

npm install workers-mcp

以下のコマンドを実行して設定を行います。

npx workers-mcp setup

これにより、以下の操作が行われます。

• 必要な依存関係を追加する
• テスト用のローカルプロキシを設定する
• MCP仕様に合わせてWorkerを構成する

💻 使用例

基本的な使用法

src/index.ts ファイルを更新して、MCPサーバーを定義します。

import { WorkerEntrypoint } from 'cloudflare:workers';
import { ProxyToSelf } from 'workers-mcp';

export default class MyWorker extends WorkerEntrypoint<Env> {
  /**
   * あなたのMCPサーバーからの友好的な挨拶です。
   * @param name {string} ユーザーの名前。
   * @return {string} 個別の挨拶文。
   */
  sayHello(name: string) {
    return `こんにちは、MCPワーカーから、${name}！`;
  }

  /**
   * @ignore
   */
  async fetch(request: Request): Promise<Response> {
    return new ProxyToSelf(this).fetch(request);
  }
}

主要コンポーネント：

• WorkerEntrypoint：受信したリクエストとメソッドの公開を管理します。
• ProxyToSelf：MCPプロトコルの準拠を確保します。
• sayHelloメソッド：AIエージェントが呼び出せるサンプルのMCP関数です。

高度な使用法

外部APIを統合することで、MCPサーバーを拡張することができます。以下は、天気データを取得する例です。

export default class WeatherWorker extends WorkerEntrypoint<Env> {
  /**
   * 指定された場所の天気データを取得します。
   * @param location {string} 都市または郵便番号。
   * @return {object} 天気の詳細。
   */
  async getWeather(location: string) {
    const response = await fetch(`https://api.weather.example/v1/${location}`);
    const data = await response.json();
    return {
      temperature: data.temp,
      conditions: data.conditions,
      forecast: data.forecast
    };
  }

  async fetch(request: Request): Promise<Response> {
    return new ProxyToSelf(this).fetch(request);
  }
}

🚀 デプロイ

コードの記述が完了したら、以下のコマンドを使用してMCPサーバーをデプロイできます。

npm run dev

これにより、開発環境でWorkerが起動します。

🧪 テスト

MCPサーバーをテストするには、以下のコマンドを使用します。

curl http://localhost:8787

あなたが記述したコードに応じて、適切な応答を得ることができます。

🔒 セキュリティ対策

MCPサーバーを保護するために、以下のセキュリティ対策を推奨します。

1. 適切なCORSポリシーを設定する。
2. 環境変数を使用して機密情報を保存する。
3. 乱用を防止するためにレート制限を有効にする。

以上の手順に従うことで、Cloudflare WorkersをベースにしたMCPサーバーを構築し、外部APIを統合して基本的なテストを行うことができます。