🚀 TeyMCP-Server
The One MCP to Rule Them All - 统一管理和调用所有MCP服务器的终极聚合器
📖 简介
TeyMCP-Server 是一个强大的 MCP (Model Context Protocol) 聚合器，让你可以通过统一的接口管理和调用多个上游 MCP 服务器。
✨ 核心特性
- 🎯 统一管理 - 一个接口调用所有MCP工具
- 🔄 动态配置 - 热加载服务器，无需重启
- 🌐 Web管理面板 - 直观的可视化管理界面
- 📊 实时监控 - 服务器状态、调用日志、性能指标
- 🔧 RESTful API - 完整的HTTP API支持
- 🔌 WebSocket - 实时数据推送
- 🐳 Docker支持 - 一键容器化部署
- ☸️ Kubernetes就绪 - 生产级编排配置
- 📚 完整文档 - 详尽的中文文档
🎬 快速演示
# 一键安装
curl -fsSL https://raw.githubusercontent.com/zf13883922290/TeyMCP-Server/main/scripts/install.sh | bash
# 配置
cp config/.env.example config/.env
nano config/.env
# 启动
bash scripts/start.sh
# 访问
open http://localhost:8080📋 目录
🔧 安装
系统要求
- Python 3.11+
- Node.js 18+ (用于上游MCP)
- 512MB+ 内存
- Ubuntu 20.04+ / macOS / Windows WSL
快速安装
# 克隆仓库
git clone https://github.com/zf13883922290/TeyMCP-Server.git
cd TeyMCP-Server
# 运行安装脚本
bash scripts/install.sh
# 配置环境变量
cp config/.env.example config/.env
nano config/.env
# 启动服务
bash scripts/start.shDocker安装
# 使用Docker Compose
cd docker
docker-compose up -d
# 查看日志
docker-compose logs -f详细安装说明: 📖 安装文档
⚙️ 配置
环境变量 (config/.env)
# GitHub Token
GITHUB_TOKEN=ghp_your_github_token_here
# Gitee Token
GITEE_TOKEN=your_gitee_token_here
# 应用配置
APP_HOST=0.0.0.0
APP_PORT=8080
LOG_LEVEL=INFO服务器配置 (config/servers.yaml)
servers:
github:
command: npx
args:
- "-y"
- "@modelcontextprotocol/server-github"
env:
GITHUB_PERSONAL_ACCESS_TOKEN: ${GITHUB_TOKEN}
enabled: true
critical: true
description: "GitHub官方MCP"
gitee:
command: npx
args:
- "-y"
- "@gitee/mcp-gitee@latest"
env:
GITEE_ACCESS_TOKEN: ${GITEE_TOKEN}
enabled: true
critical: true
description: "Gitee官方MCP"完整配置说明: 📖 配置文档
🚀 使用
Web管理面板
访问 http://localhost:8080 查看：
- 📊 服务器状态监控
- 🔧 可用工具列表
- 📝 实时调用日志
- 📈 性能指标统计
API调用示例
查看所有工具
curl http://localhost:8080/api/tools调用工具
curl -X POST http://localhost:8080/api/tools/github_create_issue/call \
-H "Content-Type: application/json" \
-d '{
"arguments": {
"owner": "zf13883922290",
"repo": "TeyMCP-Server",
"title": "Test Issue",
"body": "Created via API"
}
}'查看服务器状态
curl http://localhost:8080/api/servers完整API文档: 📖 API文档
📡 API文档
TeyMCP-Server 提供完整的 RESTful API：
- 📊 状态查询 -
/api/status,/api/health - 🖥️ 服务器管理 -
/api/servers/* - 🔧 工具管理 -
/api/tools/* - 📝 日志查询 -
/api/logs - 🔌 WebSocket -
/ws
交互式API文档: http://localhost:8080/api/docs
🚢 部署
单机部署
# 使用systemd
sudo cp scripts/teymcp.service /etc/systemd/system/
sudo systemctl enable teymcp
sudo systemctl start teymcpDocker部署
# 构建镜像
docker build -t teymcp-server -f docker/Dockerfile .
# 运行容器
docker run -d \
--name teymcp-server \
-p 8080:8080 \
-v $(pwd)/config:/app/config \
teymcp-serverKubernetes部署
# 应用配置
kubectl apply -f k8s/
# 查看状态
kubectl get pods -n teymcp详细部署指南: 📖 部署文档
💻 开发
项目结构
TeyMCP-Server/
├── src/
│ ├── main.py # 主入口
│ ├── core/ # 核心逻辑
│ │ └── aggregator.py # MCP聚合器
│ ├── api/ # API路由
│ ├── web/ # Web界面
│ ├── models/ # 数据模型
│ └── utils/ # 工具函数
├── config/ # 配置文件
├── docs/ # 文档
├── scripts/ # 脚本
├── docker/ # Docker配置
└── tests/ # 测试本地开发
# 安装开发依赖
pip install -r requirements-dev.txt
# 运行测试
pytest
# 代码格式化
black src/
isort src/
# 启动开发服务器
uvicorn src.main:app --reload添加新的MCP服务器
- 编辑
config/servers.yaml - 添加服务器配置
- 重启服务或调用
/api/servers添加
开发文档: 📖 开发指南
🤝 贡献
欢迎贡献代码、报告问题或提出建议！
如何贡献
- Fork 仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
贡献指南: 📖 CONTRIBUTING.md
📚 文档
🌟 支持的MCP服务器
- ✅ GitHub - 官方GitHub MCP
- ✅ Gitee - Gitee中国版
- ✅ Filesystem - 文件系统访问
- ✅ PostgreSQL - 数据库操作
- ✅ SQLite - 轻量数据库
- ✅ Slack - 团队协作
- ✅ AWS - 云服务管理
- ✅ Cloudflare - CDN和边缘计算
- 🔄 更多支持中...
查看完整列表: 支持的MCP服务器
📊 统计
🆘 获取帮助
📄 许可证
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
🙏 致谢
感谢所有为项目做出贡献的开发者！
特别感谢：
⭐ Star历史
如果这个项目对你有帮助，请给个 ⭐️ Star!
Made with ❤️ by zf13883922290