Jons MCP Cookiecutter

Python MCP服务器Cookiecutter模板

此存储库包含 炊具切割器 使用FastMCP创建基于Python的MCP（模型上下文协议）服务器的模板。

使用此模板

选项1：使用uvx（推荐）

使用此模板的最简单方法是 uvx，无需永久安装即可运行cookiecutter：

# From a GitHub repository
uvx cookiecutter gh:jonmmease/jons-mcp-cookiecutter

# Or from a local clone
uvx cookiecutter /path/to/jons-mcp-cookiecutter

选项2：安装带紫外线的炊具

# Install cookiecutter as a tool
uv tool install cookiecutter

# Then run it
cookiecutter gh:YOUR_USERNAME/jons-mcp-cookiecutter

选项3：使用pip/pipx

# With pipx (recommended for CLI tools)
pipx install cookiecutter
cookiecutter gh:YOUR_USERNAME/jons-mcp-cookiecutter

# Or with pip
pip install cookiecutter
cookiecutter gh:YOUR_USERNAME/jons-mcp-cookiecutter

模板变量

运行cookiecutter时，系统会提示您输入以下值：

这 project_slug 和 pkg_name 自动衍生自 project_name:

• project_slug：带连字符的小写字母（用于目录名、CLI命令）
• pkg_name：带下划线的小写字母（用于Python导入）

世代之后

创建项目后：

# Navigate to the new project
cd my-mcp-server

# Install dependencies
uv pip install -e ".[dev]"

# Run the server
uv run my-mcp-server

# Run tests
uv run pytest

添加到克劳德代码

cd my-mcp-server
claude mcp add my-mcp-server -- uv run --project "$(pwd)" my-mcp-server

包含什么

生成的项目包括：

• FastMCP服务器设置 使用示例工具
• 项目结构 遵循Python最佳实践(src/ 布局）
• 试验脚手架 带pytest和夹具
• 开发工具 配置（黑色、褶边、mypy、pytest）
• CLAUDE.md 用于AI助手指导
• README.md 附有使用说明

自定义模板

要修改此模板，请执行以下操作：

1. 克隆此存储库
2. 编辑文件 {{cookiecutter.project_slug}}/
3. 使用 {{ cookiecutter.variable_name }} 对于模板变量
4. 更新 cookiecutter.json 添加/修改变量

模板结构

jons-mcp-cookiecutter/
├── README.md                    # This file (not copied to output)
├── cookiecutter.json            # Template variable definitions
└── {{cookiecutter.project_slug}}/   # Template directory
    ├── .gitignore
    ├── CLAUDE.md
    ├── README.md
    ├── pyproject.toml
    ├── src/
    │   ├── __init__.py
    │   └── {{cookiecutter.pkg_name}}/
    │       ├── __init__.py
    │       ├── constants.py
    │       ├── exceptions.py
    │       ├── server.py
    │       ├── utils.py
    │       └── tools/
    │           ├── __init__.py
    │           └── example.py
    └── tests/
        ├── __init__.py
        ├── conftest.py
        └── test_example.py

许可证

麻省理工学院