My MCP Server

My MCP Server is a Python template for building a Model Context Protocol (MCP) server. It uses FastMCP to expose tools via JSON-RPC over stdio (and can be extended to HTTP), enabling secure and scalable context and tool invocation for language models.

Project Structure

├── src/ Source code (package: my_mcp_server) │ ├── server.py Entry point and tool registrations │ ├── main.py Console script entry │ ├── config/ Configuration modules │ ├── context/ Context providers for MCP │ ├── models/ Pydantic models and schemas │ ├── tools/ Custom tool implementations │ └── utils/ Helper utilities ├── tests/ Unit, integration, and performance tests ├── Taskfile.yaml Common development and CI tasks ├── pyproject.toml Project metadata and build configuration ├── requirements.txt Runtime dependencies └── docs/ Contribution & architecture guides

Prerequisites

• Python >=3.13

• Git

• (Optional) Taskfile task runner

Setup

Create and activate virtual environment

task create-venv source .venv/bin/activate

Install runtime dependencies

task install-requirements

(Optional) Install development dependencies

task install-dev

Taskfile Tasks

Run task --list to see all available tasks. Common tasks include:

• default: List available tasks

• create-venv: Create a Python virtual environment in .venv

• activate-venv: Show activation commands for the venv

• clean-venv: Remove the .venv directory

• install-requirements: Install runtime dependencies (pip install -r requirements.txt)

• install-dev: Install the project in editable mode with dev dependencies (pip install -e ".[dev]")

• flake8: Run flake8 over src/ and tests/

• mypy: Run mypy over src/ and tests/

• black: Format code with black

• format: Alias for black (formats all Python files)

• lint: Run both flake8 and mypy

• test: Run all tests (unit, integration, performance) with pytest

• test-unit: Run unit tests only

• test-integration: Run integration tests only

• test-performance: Run performance tests only

• coverage: Generate coverage report (HTML + terminal) with pytest-cov

• check: Run format, lint, and test sequentially

• run: Start the console-based MCP server (python -m my_mcp_server)

• dev: Alias for run (start server in development mode)

• clean: Clean Python build artifacts and caches

• build: Build distribution packages (sdist & wheel) using Hatchling

Development & Usage

After setup, you can start the server in stdio mode:

task run

Or directly:

python -m my_mcp_server

Testing & Linting

• Run all tests: task test

• Run linters: task lint

• Format code: task format

Build & Release

• Build distributions: task build

• Upload to PyPI: twine upload dist/*

Configuration

Environment variables can be managed via a .env file (loaded by python-dotenv/pydantic-settings).

Contributing

See docs/CONTRIBUTING.md for guidelines on contributing and architecture details.

License

MIT License