MCP Pyodide

🚀 mcp-pyodide

A Pyodide server implementation for the Model Context Protocol (MCP). This server enables Large Language Models (LLMs) to execute Python code through the MCP interface.

🚀 Quick Start

mcp-pyodide is a Pyodide server implementation for the Model Context Protocol (MCP), allowing LLMs to execute Python code via the MCP interface.

✨ Features

• Enables LLMs to execute Python code via Pyodide.
• Server implementation compliant with the MCP protocol.
• Supports stdio and SSE transmission modes.
• Robust implementation written in TypeScript.
• Can be used as a command-line tool.

📦 Installation

npm install mcp-pyodide

💻 Usage Examples

Basic Usage

As a Server

import { runServer } from "mcp-pyodide";

// Start the server
runServer().catch((error: unknown) => {
  console.error("Error starting the server:", error);
  process.exit(1);
});

As a Command-Line Tool

Start in stdio mode (default):

mcp-pyodide

Start in SSE mode:

mcp-pyodide --sse

Advanced Usage

SSE Mode

When running in SSE mode, the server provides the following endpoints:

• SSE connection: http://localhost:3020/sse
• Message handler: http://localhost:3020/messages

Example client connection:

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

📚 Documentation

Project Structure

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

Dependencies

Development Environment

Install Dependencies

Install all necessary packages using npm or yarn:

npm install
# or
yarn install

Start the Server

To start the server, run the following command:

npm start
# or
yarn start

Scripts

• npm run build: Build the project.
• npm run dev: Run in development mode.
• npm test: Run tests.

🔧 Technical Details

⚠️ Important Note

The project is currently in its early stages. It is recommended to conduct thorough testing before using it in a production environment.

💡 Usage Tip

If you need help or want to report an issue, please visit GitHub or send an email to support@example.com.

📄 License

If you encounter any problems, please seek support through the following methods:

• Submit an Issue.
• Send an email to support@example.com.