Skip to main content
Glama
astrodevit-creator

mcp-server-skeleton

mcp-server-skeleton

A minimal Model Context Protocol (MCP) server skeleton — stdlib only (JSON-RPC 2.0 over stdio). Implements the core handshake (initialize, tools/list, tools/call) so you can register your own tools with zero external dependencies. Wire in Shopify / Meta Ads / Supabase / n8n and expose them to Claude, Cursor, Codex, Gemini, or Hermes.

Original project, aligned with the "Agent Skills / MCP" trend. Not another MCP directory — a runnable server you extend.

Register a tool

from mcp_server import MCPServer

server = MCPServer("my-tools", "0.1.0")
server.register_tool(
    "add", "Add two numbers",
    {"type": "object", "properties": {"a": {"type": "number"}, "b": {"type": "number"}}},
    lambda args: str(args["a"] + args["b"]),
)
server.serve_stdio()

Related MCP server: veriloop

Testing

pip install -e ".[dev]"
pytest

License

MIT — see LICENSE.


Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    C
    maintenance
    Exposes a verified tool registry (calculator, sandboxed file read, web fetch) over MCP stdio, enabling any MCP-capable client to reuse the same tools from the inspectable ReAct loop.
    3
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables local tool calling over Model Context Protocol via stdio, providing deterministic tools such as calc.add, text.word_count, and text.summarize_naive after JSON-RPC handshake and discovery.
    MIT