mcp-ピオジド

モデルコンテキストプロトコル（MCP）用のPyodideサーバー実装。このサーバーにより、大規模言語モデル（LLM）がMCPインターフェースを介してPythonコードを実行できるようになります。

特徴

Pyodide を使用した LLM 向け Python コード実行機能
MCP準拠のサーバー実装
stdio と SSE トランスポートモードの両方をサポート
TypeScriptで書かれた堅牢な実装
コマンドラインツールとして利用可能

インストール

npm install mcp-pyodide

使用法

サーバーとして

import { runServer } from "mcp-pyodide";

// Start the server
runServer().catch((error: unknown) => {
  console.error("Error starting server:", 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("Received:", JSON.parse(event.data));
};

プロジェクト構造

mcp-pyodide/
├── src/
│   ├── formatters/    # Data formatting handlers
│   ├── handlers/      # Request handlers
│   ├── lib/          # Library code
│   ├── tools/        # Utility tools
│   ├── utils/        # Utility functions
│   └── index.ts      # Main entry point
├── build/            # Build artifacts
├── pyodide-packages/ # Pyodide-related packages
└── package.json

依存関係

@modelcontextprotocol/sdk : MCP SDK (^1.4.0)
pyodide : Python ランタイム環境 (^0.27.1)
arktype : 型検証ライブラリ (^2.0.1)
express : SSE サポート用の Web フレームワーク
cors : SSE サポート用の CORS ミドルウェア

発達

要件

Node.js 18以上
npm 9以上

設定

# Clone the repository
git clone <repository-url>

# Install dependencies
npm install

# Build
npm run build

スクリプト

npm run build : TypeScript をコンパイルし、実行権限を設定する
npm start : stdioモードでサーバーを実行する
npm run start:sse : SSEモードでサーバーを実行する

環境変数

PYODIDE_CACHE_DIR : Pyodide キャッシュのディレクトリ (デフォルト: "./cache")
PYODIDE_DATA_DIR : マウントされたデータのディレクトリ（デフォルト: "./data")
PORT : SSEサーバーのポート（デフォルト: 3020）

ライセンス

マサチューセッツ工科大学

貢献

リポジトリをフォークする
機能ブランチを作成する ( git checkout -b feature/amazing-feature )
変更をコミットします ( git commit -am 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを作成する

重要な注意事項

このプロジェクトは開発中であり、APIは変更される可能性があります。
実稼働で使用する前に徹底的にテストする
セキュリティ上の理由から、信頼できないコードを実行するときは注意してください
SSEモードを使用する場合は、必要に応じて適切なCORS構成を確認してください。

サポート

問題や質問については、問題追跡システムをご利用ください。

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

モデルコンテキストプロトコル (MCP) を介して大規模言語モデル (LLM) によって Python コードを実行するための Pyodide サーバー。

Related Resources

Reddit Discussion about this server

Related MCP Servers

Python MCP Server
hesiod-au
-
security
A
license
-
quality
A Model Context Protocol server that extracts and analyzes Python code structures, focusing on import/export relationships between files to help LLMs understand code context.
Last updated -
4
Python
MIT License
MCP Server for continue.dev
alexsmirnov
A
security
F
license
A
quality
A Python server implementing the Model Context Protocol to provide customizable prompt templates, resources, and tools that enhance LLM interactions in the continue.dev environment.
Last updated -
2
Python
mcp-run-pythonofficial
pydantic
-
security
A
license
-
quality
Model Context Protocol server to run Python code in a sandbox.
Last updated -
1,462
10,016
Python
MIT License
MCP Python Interpreter
yzfly
A
security
F
license
A
quality
A Model Context Protocol server that allows LLMs to interact with Python environments, execute code, and manage files within a specified working directory.
Last updated -
9
37
Python

View all related MCP servers

mcp-pyodide