AI导哈

MCP工具服务器模板

一个基于FastAPI、uv和Docker的Model Context Protocol (MCP)工具服务器模板，支持快速创建和部署MCP工具服务器。

  • by mibexx
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mibexx/mbxai-mcp-server-template

使用说明

MCP工具服务器模板

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

特性

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

需求

用法

创建新项目

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 的

相关 MCP