MCP服务器模板

Name: MCP服务器模板
Author: Data-Everything

作者：Data-Everything8 星标更新：2025-08-29

安装使用来源：spider==github.com

项目介绍

🚀 该项目已迁移！

⚠️ 重要通知：此仓库已重命名并迁移到 MCP 平台

变更内容：

新仓库：Data-Everything/MCP-Platform

新包：pip install mcp-platform（替换 mcp-templates）

新 CLI：mcpp 命令（替换 mcpt）

增强功能：改进架构和扩展能力

迁移简单易行：
# 卸载旧包
pip uninstall mcp-templates

# 安装新包
pip install mcp-platform

# 使用新命令（所有配置保持不变！）
mcpp deploy demo  # 替代 mcpt deploy demo
📚 完整的迁移指南 | 🆕 新文档

MCP 服务器模板（遗留版）

⚠️ 此版本处于维护模式。请迁移到 MCP 平台获取最新特性和更新。

� 迁移到 MCP 平台 • 💬 Discord 社区 • � 遗留文档

</div>

几秒钟内部署模型上下文协议（MCP）服务器，而不是几个小时。

使用 Docker 容器进行零配置部署的生产就绪 MCP 服务器，提供全面的 CLI 工具和智能缓存。专注于 AI 集成，而非基础设施设置。

🚀 快速开始

# 安装 MCP 模板
pip install mcp-templates

# 列出可用模板
mcpt list

# 即时部署
mcpt deploy demo

# 查看部署
mcpt logs demo

就这样！ 您的 MCP 服务器正在 http://localhost:8080 运行。

⚡ 为什么选择 MCP 模板？

传统 MCP 设置	使用 MCP 模板
❌ 复杂配置	✅ 一键部署
❌ 需要 Docker 技能	✅ 零配置需求
❌ 手动工具发现	✅ 自动检测
❌ 环境设置难题	✅ 预构建容器

适用于： AI 开发者、数据科学家、使用 MCP 构建的 DevOps 团队。

🌟 主要特性

🖱️ 一键部署

即时部署预构建模板的 MCP 服务器——无需 Docker 知识。

🔍 智能工具发现

自动查找并展示您的服务器提供的每个工具。

🧠 智能缓存

6 小时模板缓存，自动失效以实现闪电般快速的操作。

💻 强大的 CLI

用于部署、管理和工具执行的综合命令行界面。

🛠️ 灵活配置

通过 JSON、YAML、环境变量、CLI 选项或覆盖参数进行配置。

📦 不断增长的模板库

针对常见用例的现成模板：文件系统、数据库、API 等。

📚 安装

PyPI（推荐）

pip install mcp-templates

Docker

docker run --privileged -it dataeverything/mcp-server-templates:latest deploy demo

从源码安装

git clone https://github.com/DataEverything/mcp-server-templates.git
cd mcp-server-templates
pip install -r requirements.txt

🎯 常见用例

使用自定义配置部署

# 基本部署
mcpt deploy filesystem --config allowed_dirs="/path/to/data"

# 高级覆盖
mcpt deploy demo --override metadata__version=2.0 --transport http

管理部署

# 列出所有部署
mcpt list --deployed

# 停止部署
mcpt stop demo

# 查看日志
mcpt logs demo --follow

模板开发

# 创建新模板
mcpt create my-template

# 本地测试
mcpt deploy my-template --backend mock

🏗️ 架构

┌─────────────┐    ┌───────────────────┐    ┌─────────────────────┐
│  CLI 工具   │───▶│ 部署管理器        │───▶│ 后端（Docker）      │
│  (mcpt)     │    │                   │    │                     │
└─────────────┘    └───────────────────┘    └─────────────────────┘
       │                      │                        │
       ▼                      ▼                        ▼
┌─────────────┐    ┌───────────────────┐    ┌─────────────────────┐
│ 模板发现     │    │ 缓存管理器        │    │ 容器实例            │
│              │    │ (6小时TTL)        │    │                     │
└─────────────┘    └───────────────────┘    └─────────────────────┘

配置流程： 模板默认值 → 配置文件 → CLI 选项 → 环境变量

📦 可用模板

模板	描述	传输	用例
demo	Hello World MCP 服务器	HTTP, stdio	测试与学习
filesystem	安全文件操作	stdio	文件管理
gitlab	GitLab API 集成	stdio	CI/CD 工作流
github	GitHub API 集成	stdio	开发工作流
zendesk	客户支持工具	HTTP, stdio	支持自动化

查看所有模板 →

🛠️ 配置示例

基本配置

mcpt deploy filesystem --config allowed_dirs="/home/user/data"

高级配置

mcpt deploy gitlab \
  --config gitlab_token="$GITLAB_TOKEN" \
  --config read_only_mode=true \
  --override metadata__version=1.2.0 \
  --transport stdio

配置文件

{
  "allowed_dirs": "/home/user/projects",
  "log_level": "DEBUG",
  "security": {
    "read_only": false,
    "max_file_size": "100MB"
  }
}

mcpt deploy filesystem --config-file myconfig.json

🔧 模板开发

创建模板

使用生成器：
```
mcpt create my-template
```

定义 template.json：

{
  "name": "我的模板",
  "description": "自定义 MCP 服务器",
  "docker_image": "my-org/my-mcp-server",
  "transport": {
    "default": "stdio",
    "supported": ["stdio", "http"]
  },
  "config_schema": {
    "type": "object",
    "properties": {
      "api_key": {
        "type": "string",
        "env_mapping": "API_KEY",
        "sensitive": true
      }
    }
  }
}

测试和部署：
```
mcpt deploy my-template --backend mock
```

完整的模板开发指南 →

� 迁移到 MCP 平台

此仓库已演变为 MCP 平台，具有增强的功能和更好的架构。

为何迁移

更好的命名："MCP 平台" 更好地反映了项目的综合性
增强的架构：改进的代码库结构和性能
扩展的功能：更多的部署选项、更好的工具、增强的模板
未来的增长：更好地定位即将到来的 MCP 生态系统发展

什么保持不变

✅ 您的所有现有配置保持不变
✅ 相同的 Docker 镜像和模板
✅ 相同的部署工作流
✅ 过渡期间完全向后兼容

迁移步骤

安装新包：

pip uninstall mcp-templates
pip install mcp-platform

更新命令：

# 旧命令
mcpt deploy demo

# 新命令（其他部分相同）
mcpp deploy demo

更新文档书签：
- 新文档：https://data-everything.github.io/MCP-Platform/
- 新仓库：https://github.com/Data-Everything/MCP-Platform

支持时间线

当前（遗留）包：安全更新仅到 2025 年
新平台：积极开发，新功能，全面支持
迁移支持：通过 Discord 和 GitHub 问题提供

🚀 现在开始您的迁移 →

�📖 文档（遗留）

入门指南 - 安装和首次部署
CLI 参考 - 完整命令文档
模板指南 - 创建和配置模板
用户指南 - 高级用法和最佳实践

🤝 社区

Discord 服务器 - 获取帮助和讨论功能
GitHub 问题 - 报告错误和请求功能
讨论 - 分享模板和用例

📝 许可证

本项目根据 Elastic 许可证 2.0 发布。

🙏 致谢

为 MCP 社区用心打造。感谢所有贡献者和模板创建者！