py-easy-mcp ⚡🤖

Ultra-lightweight, zero-dependency Python framework for Model Context Protocol (MCP). Build MCP servers for Claude in seconds.

Turn standard Python functions into Model Context Protocol tools, resources, and prompt templates for Claude Desktop and Claude Code with simple decorators.

⚡ Why easy-mcp?

• Zero dependencies: Written in 100% pure standard Python. No heavy ASGI servers, no complex async overhead.
• Full MCP Protocol Support (v0.2.0): Supports Tools (@mcp.tool()), Resources (@mcp.resource()), and Prompt Templates (@mcp.prompt()).
• Pythonic & Simple: Turn any Python function into an MCP primitive with clean decorators.
• Automatic Schema Inspection: Docstrings and type annotations are automatically converted into standard JSON Schemas.
• Claude Desktop Ready: Built-in config generator outputs the exact JSON configuration to paste into claude_desktop_config.json.
• Offline & Safe: Standard I/O (stdio) JSON-RPC 2.0 communication.

📦 Installation

pip install py-easy-mcp

🚀 30-Second Quickstart

1. Write your server (my_server.py)

from easy_mcp import EasyMCP

mcp = EasyMCP(name="my-server", version="0.2.0")

# 1. Register a Tool
@mcp.tool()
def add(a: float, b: float) -> float:
    """Add two numbers together.

    Args:
        a: First number
        b: Second number
    """
    return a + b

# 2. Register a Resource (readable context)
@mcp.resource("memo://project-guidelines")
def guidelines() -> str:
    """Project engineering principles."""
    return "1. Keep it simple.\n2. Zero external dependencies.\n3. Write clear tests."

# 3. Register a Prompt Template
@mcp.prompt()
def code_review(code: str, language: str = "python") -> str:
    """Review code for bugs and maintainability."""
    return f"Please review this {language} snippet:\n\n{code}"

if __name__ == "__main__":
    mcp.run()

2. Add to Claude Desktop

Generate the configuration snippet:

easy-mcp config my_server.py

Output:

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

Paste this into your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Restart Claude Desktop, and your tools, resources, and prompts will appear!

🛠️ CLI Utilities

Scaffold a new server in 1 second:

easy-mcp init weather-server

Generate config for Claude Desktop:

easy-mcp config server.py

📂 Community MCP Examples (Help Wanted!)

We are building a curated collection of lightweight MCP tool servers in examples/:

• examples/basic_math.py - Math calculator
• examples/pii_shield_mcp.py - AI data privacy sanitizer

Want to contribute?

Help us add more examples for Hacktoberfest:

• 🌐 SQLite database query tool
• 📰 Hacker News API reader
• 📁 Local markdown note searcher
• ⛅ Weather lookup

See CONTRIBUTING.md to submit an example!

📄 License

MIT License © 2026 lui01212