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

Install dependencies:

uv sync

Run the MCP server:

# stdio uv run fastmcp run mcp_tools/main.py

# 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

Build the Docker image:
docker build -t python-mcp-template:latest .
Run the container:
docker run -i --rm -p 8000:8000 python-mcp-template:latest
Run MCP Server:

{ "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:
chmod +x scripts/build_docs.sh scripts/build_docs.sh mkdocs build