zeromcp

Overview

Zeromcp is a lightweight, handcrafted MCP server implementation written in pure Python with zero external dependencies. It focuses on providing a minimal yet robust implementation that allows developers to expose tools with clean Python type annotations. The server supports both HTTP/SSE and stdio transports, making it compatible with a wide range of MCP clients. Its simplicity and performance make it ideal for embedding MCP capabilities in existing Python applications.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• greetdef greet(name: Annotated[str, 'Name to greet'], age: Annotated[int | None, 'Age of person'] = None) -> str

  Generate a greeting message

  Try:Hello, greet JohnTry:Hello, greet Alice age 30
• struct_getdef struct_get(names: Annotated[list[str], 'Array of structure names'] | Annotated[str, 'Single structure name']) -> list[StructInfo]

  Retrieve structure information by names

  Try:Get info for struct1 and struct2Try:Get info for my_struct
• dividedef divide(numerator: Annotated[float, 'Numerator'], denominator: Annotated[float, 'Denominator']) -> float

  Divide two numbers

  Try:Divide 10 by 2Try:Calculate 15 divided by 3
• read_filedef read_file() -> dict

  Get information about data.txt

  Try:Read info from data.txtTry:What's in data.txt?
• read_any_filedef read_any_file(filename: Annotated[str, 'Name of file to read']) -> dict

  Get information about any file

  Try:Read info from config.jsonTry:What about this file: report.pdf
• code_reviewdef code_review(code: Annotated[str, 'Code to review'], language: Annotated[str, 'Programming language'] = 'python') -> str

  Review code for bugs and improvements

  Try:Review this Python code: print('hello')Try:Analyze this JavaScript code: function test() {}

Comparable tools

Installation

pip install zeromcp

uv add zeromcp

{
  "mcpServers": {
    "zeromcp-server": {
      "command": "python",
      "args": ["path/to/your/server.py"]
    }
  }
}

{
  "mcpServers": {
    "zeromcp-server": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

FAQ

What makes zeromcp different from other MCP servers?

Zeromcp uses zero external dependencies, is written in pure Python, and provides type-safe tool definitions using native Python annotations.

Which transport protocols does zeromcp support?

Zeromcp supports both HTTP/SSE and stdio transports, making it compatible with a wide range of MCP clients including Claude Desktop, VS Code, and others.

Compare zeromcp with