Python Mcp Template

Python MCP Template

> A DevOps-friendly template with CI/CD, Docker, and Documentation-as-Code (DaC) for building MCP server

🚀 Core Idea

This template leverages fastmcp and FastAPI to seamlessly integrate MCP functionality while inheriting the original OpenAPI specifications.

🌟 Features

• CI/CD Integration: Automate your workflows with GitHub Actions.
• Dockerized Environment: Consistent and portable development and production environments.
• Documentation-as-Code: Automatically generate and deploy documentation using MkDocs. This process also utilizes the openapi.json file to ensure API documentation is up-to-date.
• FastAPI Integration: Build robust APIs with OpenAPI support.

🛠️ Getting Started

Local Development

1. Install dependencies:

``bash uv sync ``

1. Run the MCP server:

``bash # stdio uv run fastmcp run mcp_tools/main.py ``

``bash # HTTP (Due to CORS middleware conflicts, additional setup is required) uv run uvicorn mcp_tools.main_http:starlette_app --host 127.0.0.1 --port 8000 ``

> > - https://gofastmcp.com/deployment/http > - https://github.com/jlowin/fastmcp/issues/840

Docker

1. Build the Docker image:

``bash docker build -t python-mcp-template:latest . ``

1. Run the container:

``bash docker run -i --rm -p 8000:8000 python-mcp-template:latest ``

1. Run MCP Server:

``json { "mcpServers": { "python-mcp-template": { "command": "docker", "args": [ "run", "--rm", "-i", "-p", "8000:8000", "python-mcp-template:latest" ] } } } ``

📚 Documentation

• Documentation is built using MkDocs and deployed to GitHub Pages.
• To build the documentation locally:

``bash chmod +x scripts/build_docs.sh scripts/build_docs.sh mkdocs build ``

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hsiangjenli
• Source: hsiangjenli/python-mcp-template
• License: MIT
• Homepage: https://hsiangjenli.github.io/python-mcp-template/

Install and usage instructions live in the source repository linked above.