Skip to main content
Glama
mcp-py-template

mcp-py-template

by vidyasagarr7

mcp-py-template

Production-ready Model Context Protocol (MCP) server template in Python, built on the official mcp SDK (FastMCP). Ships an example tool, resource, and prompt.

Use this template

gh repo create my-mcp --template vidyasagarr7/mcp-py-template

Related MCP server: MCP Template

Layout

src/mcp_py_template/
  server.py    # FastMCP registration + stdio entry point
  core.py      # pure domain logic (testable, no MCP concerns)
  __init__.py
tests/         # pytest specs (core + server)

Golden rule: registration in server.py, logic in core.py.

Develop

uv sync --extra dev            # create .venv + install deps
uv run mcp-py-template         # run server over stdio
uv run pytest                  # tests + coverage
uv run ruff check .            # lint
uv run mypy                    # strict type-check

Inspect

uv run mcp dev src/mcp_py_template/server.py   # MCP Inspector (dev UI)

Register a new tool

  1. Add pure logic to src/mcp_py_template/core.py.

  2. Add a unit test in tests/.

  3. Register it in server.py with @mcp.tool() (type hints become the schema).

Connect from a client

{
  "mcpServers": {
    "my-mcp": { "command": "uv", "args": ["run", "mcp-py-template"] }
  }
}

Make it yours (rename checklist)

  • pyproject.toml: name, description, [project.scripts], coverage target

  • Rename the package dir src/mcp_py_template/ and update imports

  • server.py: FastMCP("mcp-py-template") name

  • Replace the example add tool / greeting resource / summarize prompt with your own

License

MIT

Available Tools

1 tool
addA

Add two numbers.

Inputs: a (required), b (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no ambiguity; the tool's purpose is clear and distinct.

    Naming Consistency5/5

    With a single tool, naming consistency is not an issue; the name 'add' is straightforward.

    Tool Count1/5

    The server has only one trivial tool (addition), which is far too few for any meaningful scope, indicating an extreme mismatch.

    Completeness1/5

    The tool set is severely incomplete for even basic arithmetic operations; only addition is provided, lacking subtraction, multiplication, etc.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A foundational template for building MCP servers in Python using Streamable HTTP transport. Provides example implementations of tools, resources, and prompts to help developers create custom MCP integrations for AI assistants.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      A production-ready Python template for building MCP servers with enterprise features including registry integration, configuration management, structured logging, and extensible patterns for tools, resources, and prompts.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A minimal template MCP server demonstrating basic tools, resources, and prompts functionality. Includes example implementations like a hello tool, history resource, and greet prompt for learning MCP development.
      ISC