使用说明
MCP 模板
使用FastMCP构建模型上下文协议(MCP)服务器的模板。
特点/功能
- 基于FastMCP的服务器实现
- 🐳 支持 Docker 和 Docker Compose
- 📦 使用 pyproject.toml 配置 Python 包
- 🔧 环境变量配置
- 📁 规整有序的文件夹结构
项目结构
.
├── docs/ # Documentation files
├── tests/ # Test files
├── src/ # Source code
├── main.py # Main entry point
├── pyproject.toml # Python project configuration
├── Dockerfile # Docker configuration
├── docker-compose.yml
├── .env # Environment variables
├── .gitignore # Git ignore rules
└── README.md # This file
安装
使用 pip
pip install -e .
使用Docker
docker-compose up --build
使用方法
在本地运行
# stdio mode (default)
python main.py
# HTTP mode
python main.py --transport streamable-http --port 8321
使用 Docker 运行
docker-compose up
服务器将在 http://localhost:8321
配置
编辑 .env 用于配置您的环境变量的文件:
# Add your configuration here
API_KEY=your_api_key_here
发展
项目设置
- 克隆此仓库
- 安装依赖项:
pip install -e . - 在(某处)配置环境变量
.env - 开始在……中进行开发
src/目录
添加工具
在(此处)添加您的MCP工具 src/ 目录并将其导入 main.py。
Docker 支持
该模板包括:
- Dockerfile采用多阶段构建并遵循安全最佳实践
- docker-compose.yml 文件轻松的容器编排
- 非root用户以无特权用户身份运行,以确保安全
- 健康检查内置健康监测功能
要求
- Python 版本 >= 3.11
- FastMCP 版本 >= 2.3.3
- Docker(可选)
许可证
麻省理工学院许可证(MIT License)
贡献;助力
欢迎贡献!请随时提交拉取请求。
