Mbxai MCP Server Template

MCP工具服务器模板

一个cookiecutter模板，用于创建支持FastAPI、uv和Docker的模型上下文协议（MCP）工具服务器。

特性

• 基于FastAPI的REST服务器
• 模型上下文协议（MCP）工具支持
• 示例天气工具实施
• 现代Python工具（uv、ruff、mypy）
• 类型提示和综合测试
• Docker对容器化的支持
• Kubernetes部署配置

需求

• Python 3.12或更高版本
• 紫外线 包管理器
• 炊具切割器 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：是否包括绒毛

项目结构

该模板创建了一个组织良好的项目结构：

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许可证下获得许可-有关详细信息，请参阅许可证文件。

关于

由...创建 Mibexx 的