mcp-pyodide

mcp-pyodide

一个基于 Pyodide 的模型上下文协议（MCP）服务实现。此服务支持大模型通过 MCP 接口执行 Python 代码。

功能

• 使用 Pyodide 为大模型提供 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）

许可证

MIT

参与贡献

1. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -am 'Add some amazing feature'）
4. 推送到该分支（git push origin feature/amazing-feature）
5. 创建 Pull Request

重要说明

• 此项目仍在开发中，API 可能会发生变化
• 在生产环境中使用前，请进行全面测试
• 出于安全考虑，执行不受信任的代码时请务必谨慎
• 使用 SSE 模式时，如有需要，请确保正确配置 CORS

支持

如有问题或疑问，请使用 Issue 跟踪器。