Geelen Workers MCP Server

🚀 ワーカーMCPプロジェクト

このプロジェクトは、Cloudflare Workersを接続および管理するためのMCP（Model Context Protocol）プロジェクトです。これにより、Cloudflare WorkersをClaude Desktopに統合し、ツールとサービスの動的ロードを実現できます。

🚀 クイックスタート

インストールと設定

依存関係のインストール

pnpm install

環境変数の設定

package.jsonに以下のスクリプトを追加します。

{
  "scripts": {
    "generate:docs": "ts-mdx src/index.ts -o docs.json",
    "watch-docs": "watchexec npm run generate:docs"
  }
}

✨ 主な機能

動作原理

1. ドキュメント生成：src/index.ts内のJSDocコメントをスキャンして、ツールとサービスのリスト（docs.json）を生成します。
2. HTTPハンドラー：/rpcエンドポイントでClaudeからの呼び出しリクエストを処理します。
3. ローカルプロキシ：MCPリクエストをリモートワーカーに転送します。

核心コンポーネント

• WorkerEntrypoint：ワーカー内のインターフェースとメソッドを定義します。
• RPC：RPC呼び出しインターフェースを提供し、同期および非同期操作をサポートします。
• LocalMCPProxy：ツールリストリクエスト（tools/list）と呼び出しリクエスト（tools/call）を処理します。

📦 インストール

依存関係のインストール

pnpm install

環境変数の設定

package.jsonに以下のスクリプトを追加します。

{
  "scripts": {
    "generate:docs": "ts-mdx src/index.ts -o docs.json",
    "watch-docs": "watchexec npm run generate:docs"
  }
}

💻 使用例

基本的な使用法

ドキュメント生成

import type { WorkerEntrypoint } from '@modelcontextprotocol/types'

export class MyWorker implements WorkerEntrypoint {
  async greet(name: string) {
    return `Hello, ${name}!`
  }
}

生成されるドキュメント:

{
  "MyWorker": {
    "methods": [
      {
        "name": "greet",
        "params": [
          {
            "type": "string",
            "name": "name"
          }
        ],
        "returns": {
          "type": "Promise.<string>",
          "description": "挨拶メッセージ"
        }
      }
    ]
  }
}

高度な使用法

HTTPハンドラー

lib/WorkerMCP.tsが/rpcエンドポイントを提供します。

export default function workerMcp() {
  return new Response(`Hello from WorkerMCP!`, {
    headers: { 'content-type': 'application/json' },
  });
}

ローカルプロキシ

scripts/local-proxy.tsでローカルプロキシサーバーを起動し、Claudeのリクエストを処理します。

import { MCPProxy } from '@modelcontextprotocol/sdk'

const proxy = new MCPProxy({
  entrypoint: 'my-worker',
  workerUrl: 'https://your.worker.url'
});

proxy.listen(3001)

🔧 技術詳細

ドキュメント生成

src/index.ts内のJSDocコメントをスキャンして、ツールとサービスのリスト（docs.json）を生成します。

HTTPハンドラー

lib/WorkerMCP.tsが/rpcエンドポイントを提供し、Claudeからの呼び出しリクエストを処理します。

ローカルプロキシ

scripts/local-proxy.tsでローカルプロキシサーバーを起動し、MCPリクエストをリモートワーカーに転送します。

📚 ドキュメント

ディレクトリ構成

worker-mcp/
  ├── src/                 # ワーカーのエントリーポイントファイル
  |    └── index.ts        # 主要なワーカーロジック
  ├── lib/                # 共通のHTTPハンドラー
  |    └── WorkerMCP.ts   # `/rpc`エンドポイントを提供
  ├── scripts/           # スクリプトとツール
  |    ├── local-proxy.ts # ローカルMCPプロキシ
  |    └── generate-docs.ts # ドキュメント生成ツール
  └── package.json       # プロジェクトの依存関係とスクリプト設定

制限と不備

1. ドキュメント生成：現在はsrc/index.tsからのドキュメント生成のみサポートしています。
2. HTTPリクエスト：同期リクエストのみサポートし、ストリーミングレスポンスはサポートしていません。
3. エラー処理：エラー処理メカニズムはまだ完全には整備されていません。

将来の計画

• リモート開発モードのサポート：再デプロイせずにデバッグできるようにします。
• ドキュメント生成ツールの改善：d.tsファイルとZodタイプからの情報抽出をサポートします。
• 通知メカニズムの実装：ツールリストの変更に対する通知を実装し、Claudeの再起動回数を減らします。

フィードバックと貢献

このプロジェクトを試してみてください！何か問題や提案があれば、GitHub で問題を投稿するか、プルリクエストを送信してください。皆さんのフィードバックと貢献をお待ちしています！