MCP服务器模板

一个基于FastMCP的MCP服务器构建模板,支持Docker和Python环境配置,适用于快速开发和部署MCP服务。

  • by OmniMCP-AI
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 OmniMCP-AI/MCP-template

使用说明

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

发展

项目设置

  1. 克隆此仓库
  2. 安装依赖项: pip install -e .
  3. 在(某处)配置环境变量 .env
  4. 开始在……中进行开发 src/ 目录

添加工具

在(此处)添加您的MCP工具 src/ 目录并将其导入 main.py。

Docker 支持

该模板包括:

  • Dockerfile采用多阶段构建并遵循安全最佳实践
  • docker-compose.yml 文件轻松的容器编排
  • 非root用户以无特权用户身份运行,以确保安全
  • 健康检查内置健康监测功能

要求

  • Python 版本 >= 3.11
  • FastMCP 版本 >= 2.3.3
  • Docker(可选)

许可证

麻省理工学院许可证(MIT License)

贡献;助力

欢迎贡献!请随时提交拉取请求。