MCP Pyodide

🚀 mcp-pyodide

Model Context Protocol (MCP) 用の Pyodide サーバー実装です。このサーバーにより、大規模言語モデル (LLMs) は MCP インターフェースを通じて Python コードを実行できます。

✨ 主な機能

• Pyodide を通じて、LLM が Python コードを実行する機能をサポート
• MCP プロトコルに準拠したサーバー実装
• stdio と SSE の伝送モードをサポート
• TypeScript で記述された強力な実装
• コマンドラインツールとして使用可能

📦 インストール

npm install mcp-pyodide

💻 使用例

基本的な使用法

サーバーとしての使用

import { runServer } from "mcp-pyodide";

// サーバーを起動
runServer().catch((error: unknown) => {
  console.error("サーバーの起動中にエラーが発生しました:", error);
  process.exit(1);
});

コマンドラインツールとしての使用

stdio モードで起動（デフォルト）:

mcp-pyodide

SSE モードで起動:

mcp-pyodide --sse

高度な使用法

SSE モード

SSE モードで実行する場合、サーバーは以下のエンドポイントを提供します:

• SSE 接続: http://localhost:3020/sse
• メッセージハンドラー: http://localhost:3020/messages

サンプルクライアント接続:

const eventSource = new EventSource("http://localhost:3020/sse");
eventSource.onmessage = (event) => {
  console.log("受信:", JSON.parse(event.data));
};

📚 ドキュメント

プロジェクト構造

mcp-pyodide/
├── src/
│   ├── formatters/    # データ形式処理ハンドラー
│   ├── handlers/      # リクエスト処理ハンドラー
│   ├── lib/          # ライブラリコード
│   ├── tools/        # ツール関数
│   ├── utils/        # 補助関数
│   └── index.ts      # エントリーファイル
├── build/            # ビルド成果物
├── pyodide-packages/ # Pyodide 関連パッケージ
└── package.json

依存関係

開発環境

依存関係のインストール

npm または yarn を使用してすべての必要なパッケージをインストールします:

npm install
# または
yarn install

サーバーの起動

サーバーを起動するには、以下のコマンドを実行します:

npm start
# または
yarn start

スクリプト

• npm run build：プロジェクトをビルド
• npm run dev：開発モードで実行
• npm test：テストを実行

⚠️ 重要な注意事項

このプロジェクトは現在初期段階であり、本番環境で使用する前に十分なテストを行うことをお勧めします。 ヘルプが必要な場合や問題を報告する場合は、GitHub を訪問するか、support@example.com にメールを送信してください。

💡 使用アドバイス

何か問題が発生した場合は、以下の方法でサポートを求めてください:

• Issue を提出する
• support@example.com にメールを送信する