Copier Mcp Py

Copier

en | ko

A Copier template for quickly scaffolding Python-based Model Context Protocol (MCP) servers.

This template provides the following architecture out of the box:

• core/ – Pure domain logic (business functions, data models)
• mcp/ – MCP server adapter (FastMCP-based Tools / Resources / Prompts)
• cli/ – Typer-based CLI for humans and scripts
• Complete Python package structure with uv + mcp[cli] + pyproject.toml

Use this when you want to generate multiple MCP servers from a single template while keeping the project structure and behavior consistent.

Features

• Built on python-sdk mcp[cli]
  • Leverages the official MCP Python SDK, FastMCP, and CLI tools as-is.
• 3-layer architecture: core / cli / mcp
  • Clearly separates domain logic (core), MCP adapter (mcp), and CLI.
• uv-friendly project structure
  • Includes uv init --lib style src/ layout + pyproject.toml + [project.scripts].
• Consistent naming conventions
  • Enter just project_name and it automatically generates:
    • Distribution name: project-slug (e.g., knowledge-ingester)
    • Package name: project_slug (e.g., knowledge_ingester)
    • MCP command: mcp-project-slug (e.g., mcp-knowledge-ingester)

Prerequisites

• Python 3.10 or higher
• uv installed
• Copier installed

Example:

pip install copier
pip install uv

Or using uv itself:

uv tool install copier

Creating a New MCP Server from Template

# 1) Generate project from template
copier copy gh:crlotwhite/copier-mcp-py knowledge-ingester

# 2) Navigate to the generated project
cd knowledge-ingester

# 3) Install dependencies and create virtual environment
uv sync

# 4) Run MCP server
uv run mcp-knowledge-ingester

# 5) Test CLI
uv run knowledge-ingester ingest-pdf ./doc.pdf --project demo

The examples above assume project_name = "Knowledge Ingester" was entered.

---

Copier Prompt Variables

When running the template, you will be prompted for the following:

Variable Name	Description	Example Value
project_name	Project display name	Knowledge Ingester
python_version	Minimum Python version	3.11

The following values are automatically derived and not prompted:

• project_slug:

  • project_name → lowercase + spaces replaced with -
  • Example: "Knowledge Ingester" → "knowledge-ingester"

• package_name:

  • project_slug with - replaced by _
  • Example: "knowledge-ingester" → "knowledge_ingester"

• mcp_command: mcp-{{ project_slug }}

• cli_command: {{ project_slug }}

• description: "{{ project_name }} MCP server built with python-sdk mcp[cli]"

---

Generated Project Structure

For example, if you enter project_name = "Knowledge Ingester", the generated project structure will look approximately like this:

knowledge-ingester/
├─ pyproject.toml
├─ README.md
├─ .python-version
├─ .gitignore
└─ src/
   └─ knowledge_ingester/
      ├─ __init__.py
      ├─ core/
      │  └─ __init__.py
      ├─ mcp/
      │  ├─ __init__.py
      │  ├─ server.py
      │  ├─ tools/
      │  │  ├─ __init__.py
      │  │  └─ example.py
      │  ├─ resources/
      │  │  ├─ __init__.py
      │  │  └─ example.py
      │  └─ prompts/
      │     ├─ __init__.py
      │     └─ example.py
      └─ cli/
         ├─ __init__.py
         └─ main.py

License

Choose your preferred license and add a LICENSE file.

(e.g., MIT, Apache-2.0, etc.)

References

• Model Context Protocol: https://github.com/modelcontextprotocol
• MCP Python SDK (mcp): https://github.com/modelcontextprotocol/python-sdk
• Copier documentation: https://copier.readthedocs.io/
• uv documentation: https://github.com/astral-sh/uv