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.

Features

Python code execution capability for LLMs using Pyodide
MCP compliant server implementation
Support for both stdio and SSE transport modes
Robust implementation written in TypeScript
Available as a command-line tool

Installation

npm install mcp-pyodide

Usage

As a Server

import { runServer } from "mcp-pyodide";

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

As a Command-line Tool

Start in stdio mode (default):

mcp-pyodide

Start in SSE mode:

mcp-pyodide --sse

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));
};

Project Structure

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

Dependencies

@modelcontextprotocol/sdk: MCP SDK (^1.4.0)
pyodide: Python runtime environment (^0.27.1)
arktype: Type validation library (^2.0.1)
express: Web framework for SSE support
cors: CORS middleware for SSE support

Development

Requirements

Node.js 18 or higher
npm 9 or higher

Setup

# Clone the repository
git clone <repository-url>

# Install dependencies
npm install

# Build
npm run build

Scripts

npm run build: Compile TypeScript and set execution permissions
npm start: Run server in stdio mode
npm run start:sse: Run server in SSE mode

Environment Variables

PYODIDE_CACHE_DIR: Directory for Pyodide cache (default: "./cache")
PYODIDE_DATA_DIR: Directory for mounted data (default: "./data")
PORT: Port for SSE server (default: 3020)

License

MIT

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -am 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Create a Pull Request

Important Notes

This project is under development, and the API may change
Thoroughly test before using in production
Exercise caution when executing untrusted code for security reasons
When using SSE mode, ensure proper CORS configuration if needed

Support

Please use the Issue tracker for problems and questions.

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

A Pyodide server for executing Python code by Large Language Models (LLMs) via the Model Context Protocol (MCP).

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
9,883
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

mcp-pyodide

Features

Installation

Usage

As a Server

As a Command-line Tool

SSE Mode

Project Structure

Dependencies

Development

Requirements

Setup

Scripts

Environment Variables

License

Contributing

Important Notes

Support

Tools

Related Resources

Related MCP Servers

Python MCP Server

MCP Server for continue.dev

mcp-run-pythonofficial

MCP Python Interpreter

Appeared in Searches

New MCP Servers

MCP directory API