mcp-pyodide

一个用于Model Context Protocol (MCP) 的 Pyodide 服务器实现。此服务器使大型语言模型（LLMs）能够通过 MCP 接口执行 Python 代码。

功能

• 支持 LLM 执行 Python 代码的能力，通过 Pyodide 实现
• 符合 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

依赖项

• @modelcontextprotocol/sdk：MCP SDK（^1.4.0）
• pyodide：Python 运行时（^1.23.0）
• rxjs：响应式扩展库（^7.8.1）
• ts-node：TypeScript 运行时（^10.9.2）

开发环境

安装依赖项

使用 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