Workers MCP Server

🚀 工人 MCP プロジェクト

このプロジェクトは、WorkerEntrypoint というクラスを MCP（モデルコンテキストプロトコル）サービスとして公開する方法を示しています。Wrangler といくつかのカスタムツールを使用することで、ローカル開発とデプロイを実現しています。

🚀 クイックスタート

インストールと実行

1. プロジェクトリポジトリをクローンします。
2. npm install を実行して依存関係をインストールします。
3. scripts/ ディレクトリで node local - proxy.ts を実行してプロキシサーバーを起動します。
4. MCP ツールを使用して WorkerEntrypoint とのやり取りをテストします。

✨ 主な機能

• WorkerEntrypoint クラスを MCP サービスとして公開する機能。
• ローカルでの開発とデプロイを可能にする機能。

📦 インストール

1. プロジェクトリポジトリをクローンします。
2. npm install を実行して依存関係をインストールします。

💻 使用例

基本的な使用法

以下は src/index.ts で定義された WorkerEntrypoint クラスの使用例です。

export class WorkerEntrypoint {
    async greet(name: string): Promise<string> {
        return `Hello, ${name}!`;
    }
}

このクラスは、MCP を通じて提供するサービスを定義しています。現在は greet という 1 つのメソッドのみがあり、文字列パラメーターを受け取り、挨拶文を返します。

高度な使用法

scripts/local - proxy.ts を使用すると、ローカルで MCP の tools/list と /rpc リクエストを処理することができます。

import { serve } from 'std/server';
import { expose } from '@modelcontextprotocol/sdk';

async function main() {
    const port = 8080;
    await serve(async (req) => {
        if (req.method === 'GET' && req.url.pathname === '/tools/list') {
            // 返回 MCP 工具列表
            return Response.json({
                tools: [{
                    name: 'WorkerEntrypoint',
                    methods: ['greet']
                }]
            });
        } else if (req.method === 'POST' && req.url.pathname === '/rpc') {
            // 处理 RPC 请求
            const body = await req.json();
            const instance = new WorkerEntrypoint();
            return Response.json({ result: await Reflect.apply(instance[body.method], instance, body.args || []) });
        }
    }, { port });
}

main();

このスクリプトは、クラウドにデプロイしなくてもテストと開発を行うことができます。

📚 ドキュメント

プロジェクト構造

project/
├── src/
│   └── index.ts               # Worker 的主要入口点
├── lib/
│   └── WorkerMCP.ts          # 公共 HTTP 处理器
├── scripts/
│   ├── local-proxy.ts        # 本地 MCP 代理
│   └── generate-docs.ts      # 文档生成脚本
└── package.json             # 项目依赖管理

キーファイルの説明

src/index.ts - ワーカーエントリポイント

export class WorkerEntrypoint {
    async greet(name: string): Promise<string> {
        return `Hello, ${name}!`;
    }
}

このクラスは、MCP を通じて提供するサービスを定義しています。現在は greet という 1 つのメソッドのみがあり、文字列パラメーターを受け取り、挨拶文を返します。

lib/WorkerMCP.ts - 公共 HTTP ハンドラー

import { expose } from '@modelcontextprotocol/sdk';
import { WorkerEntrypoint } from '../src/index';

class WorkerMCP {
    static async fetch(req: Request): Promise<Response> {
        const endpoint = new URL('/rpc', req.url);
        if (req.method !== 'POST' || !req.headers.get('Content-Type')?.includes('application/json')) {
            return Response.json({ error: 'Invalid request' }, 400);
        }

        try {
            const body = await req.json();
            const { method } = body;
            const instance = new WorkerEntrypoint();
            const result = await Reflect.apply(instance[method], instance, body.args || []);

            return Response.json({ result });
        } catch (error) {
            return Response.json({ error: error.message }, 500);
        }
    }
}

expose(WorkerMCP);

このファイルは、受信した HTTP リクエストを処理する方法を定義しています。/rpc パスを通じてエンドポイントを公開し、JSON リクエストを受け取り、対応する WorkerEntrypoint メソッドを呼び出します。

scripts/local - proxy.ts - ローカル MCP プロキシ

import { serve } from 'std/server';
import { expose } from '@modelcontextprotocol/sdk';

async function main() {
    const port = 8080;
    await serve(async (req) => {
        if (req.method === 'GET' && req.url.pathname === '/tools/list') {
            // 返回 MCP 工具列表
            return Response.json({
                tools: [{
                    name: 'WorkerEntrypoint',
                    methods: ['greet']
                }]
            });
        } else if (req.method === 'POST' && req.url.pathname === '/rpc') {
            // 处理 RPC 请求
            const body = await req.json();
            const instance = new WorkerEntrypoint();
            return Response.json({ result: await Reflect.apply(instance[body.method], instance, body.args || []) });
        }
    }, { port });
}

main();

このスクリプトは、ローカルでプロキシサーバーを実行し、MCP の tools/list と /rpc リクエストを処理します。クラウドにデプロイしなくてもテストと開発を行うことができます。

scripts/generate - docs.ts - ドキュメント生成スクリプト

import { writeFileSync } from 'fs';

const docGenerator = () => {
    const workerEntrypoint = require.resolve('../src/index');
    const content = `See the source file: ${workerEntrypoint}`;
    
    return { 
        entrypoints: [
            {
                name: 'WorkerEntrypoint',
                description: 'A simple MCP service example.',
                docUrl: 'https://example.com/docs'
            }
        ],
        tools: [{
            name: 'greet',
            description: 'Greets a person.',
            arguments: [{ name: 'name', type: 'string' }],
            returns: { type: 'string' }
        }]
    };
};

const docs = docGenerator();
writeFileSync('docs.json', JSON.stringify(docs, null, 2));

このスクリプトは、MCP 用のツールドキュメントを生成します。現在は静的にドキュメントを生成していますが、より詳細な情報を含むように拡張することができます。

🔧 技術詳細

制限事項と将来の計画

• 現在は src/index.ts から 1 つのクラスのみを公開することができます。
• 利用可能なメソッドは greet という単純なメソッドのみです。
• ドキュメント生成は静的であり、将来的にはより詳細な情報を含むように拡張することができます。

まとめ

このプロジェクトは、Wrangler とカスタムスクリプトを使用して、ワーカーエントリポイントを MCP サービスとして公開する方法を示しており、ローカルでの開発が可能です。