MCP Pyodide

🚀 mcp-pyodide

mcp-pyodide 是一个用于 Model Context Protocol (MCP) 的 Pyodide 服务器实现。该服务器可让大型语言模型（LLMs）通过 MCP 接口执行 Python 代码，为模型与 Python 代码的交互提供了便利。

🚀 快速开始

mcp-pyodide 是一个强大的工具，它允许大型语言模型通过 MCP 接口执行 Python 代码。以下是使用它的基本步骤。

✨ 主要特性

• ✅ 支持 LLM 执行 Python 代码的能力，通过 Pyodide 实现。
• ✅ 符合 MCP 协议的服务器实现，确保兼容性和稳定性。
• ✅ 支持 stdio 和 SSE 传输模式，满足不同场景需求。
• ✅ 使用 TypeScript 编写的强大实现，保证代码的健壮性。
• ✅ 可作为命令行工具使用，操作便捷。

📦 安装指南

使用以下命令安装 mcp-pyodide：

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