Workers MCP Server

🚀 工人 MCP 項目

本項目展示瞭如何將 WorkerEntrypoint 類暴露為 MCP（模型上下文協議）服務。藉助 Wrangler 和一些自定義工具，可實現本地開發與部署，為 MCP 服務的開發和測試提供了便利。

🚀 快速開始

安裝和運行

1. 克隆項目倉庫。
2. 運行 npm install 安裝依賴項。
3. 在 scripts/ 目錄中運行 node local-proxy.ts 啟動代理服務器。
4. 使用 MCP 工具測試與 WorkerEntrypoint 的交互。

✨ 主要特性

• 能夠將 WorkerEntrypoint 類暴露為 MCP 服務。
• 支持本地開發和部署，方便進行測試。
• 提供文檔生成腳本，可生成 MCP 工具文檔。

📦 項目結構

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，它接受一個字符串參數並返回問候語。

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 公開一個類。
• 只有一個簡單的 greet 方法可用。
• 文檔生成是靜態的，未來可以擴展以包含更多詳細信息。

📚 結論

這個項目展示瞭如何使用 Wrangler 和自定義腳本將工人入口點暴露為 MCP 服務，並提供了本地開發的能力。