MCP Tool Server Template

MCP 工具服务模板

一个用于创建 Model Context Protocol（MCP）工具服务的 Cookiecutter 模板，支持 FastAPI、uv 和 Docker。

功能

• 基于 FastAPI 的 REST 服务
• 支持 Model Context Protocol（MCP）工具
• 示例天气工具实现
• 现代 Python 工具（uv、ruff、mypy）
• 类型提示和全面的测试
• 支持 Docker 容器化
• Kubernetes 部署配置

要求

• Python 3.12 或更高版本
• uv 包管理器
• cookiecutter 2.5.0 或更高版本

用法

创建新项目

cookiecutter gh:mibexx/mbxai-mcp-server-template

按照提示配置项目：

• project_name：项目名称
• project_slug：项目的 slug（用于路径和导入）
• package_name：Python 包名称
• description：项目的简短描述
• author_name：您的姓名
• author_email：您的电子邮件
• open_source_license：项目的许可证
• python_version：要使用的 Python 版本
• use_pytest：是否包含 pytest 进行测试
• use_mypy：是否包含 mypy 进行类型检查
• use_ruff：是否包含 ruff 进行代码检查

项目结构

该模板会创建组织良好的项目结构：

your-project/
├── src/
│   └── your_package/
│       ├── api/                  # Core API functionality
│       ├── clients/              # Client libraries
│       ├── project/              # Project-specific code
│       │   └── weather.py        # Sample weather tool
│       ├── config.py             # Configuration management
│       └── __init__.py           # Package initialization
├── tests/                        # Test suite
├── data/                         # Data storage
├── logs/                         # Log files
├── kubernetes/                   # Kubernetes deployment files
├── Dockerfile                    # Docker configuration
├── docker-compose.yml            # Docker Compose configuration
├── pyproject.toml                # Project metadata and dependencies
└── README.md                     # Project documentation

开发

在本地运行

cd your-project
uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows
uv pip install -e .
uv run service

使用 Docker 运行

cd your-project
docker-compose up -d

部署到 Kubernetes

cd your-project
kubectl apply -f kubernetes/mbxai_resource.yaml

添加新工具

有关向 MCP 服务添加新工具的详细说明，请参阅项目的 README.md。

许可证

此模板采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

关于

由 Mibexx 创建