mcp-py-template
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-py-template add 5 and 3"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-templateRelated 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-checkInspect
uv run mcp dev src/mcp_py_template/server.py # MCP Inspector (dev UI)Register a new tool
Add pure logic to
src/mcp_py_template/core.py.Add a unit test in
tests/.Register it in
server.pywith@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 targetRename the package dir
src/mcp_py_template/and update importsserver.py:FastMCP("mcp-py-template")nameReplace the example
addtool /greetingresource /summarizeprompt with your own
License
MIT
Available Tools
1 tooladdA
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
Scored across 1 tool
With only one tool, there is no ambiguity; the tool's purpose is clear and distinct.
With a single tool, naming consistency is not an issue; the name 'add' is straightforward.
The server has only one trivial tool (addition), which is far too few for any meaningful scope, indicating an extreme mismatch.
The tool set is severely incomplete for even basic arithmetic operations; only addition is provided, lacking subtraction, multiplication, etc.
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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.-
- AlicenseNot gradedqualityDmaintenanceA 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
- AlicenseNot gradedqualityDmaintenanceA 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
- AlicenseAqualityDmaintenanceProduction-ready MCP server starter templates in TypeScript and Python. Includes tool, resource, and prompt patterns with Claude Desktop integration configs.22MIT