mcpField
M
mcp-deploy

mcp-deploy

github.com/zrongAgent 工作流1338 次安装2 周前更新
代码仓库

关于 mcp-deploy

通过 mcporter 指导部署和配置 MCP 服务的 Agent 技能。涵盖 HTTP 与 STDIO 配置、所需凭据或依赖，以及部署后的检查。

主要功能

  1. 01引导选择服务和凭据
  2. 02HTTP 与 STDIO 配置示例
  3. 03依赖和网络检查
  4. 04部署后验证

适用场景

  1. 01添加智谱 HTTP 服务
  2. 02配置 Minimax 的 STDIO 服务
  3. 03设置 Gitea 服务
  4. 04诊断无法连接的 MCP 服务

MCP 相关

指导 Agent 使用 mcporter 添加 MCP 服务、收集所需配置并检查部署是否正常。示例包括 HTTP 和 STDIO 配置。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/zrong/skills --skill mcp-deploy

安装后在 Claude Code 中输入/mcp-deploy确认已加载。

详细介绍

来自项目 README

MCP Deploy

自动部署和配置各种 MCP 服务器。

支持的 MCP 平台

平台类型需要的配置
智谱 (zhipu)HTTPAPI Key
智谱搜索 (web-search-prime)HTTPAPI Key
智谱网页读取 (web-reader)HTTPAPI Key
智谱 GitHub (zread)HTTPAPI Key
MinimaxSTDIOAPI Key
GiteaSTDIOAPI URL + Token + 二进制
其他 MCPSTDIO/HTTP根据具体情况

工作流程

  1. 确认 MCP 平台：询问用户要部署哪个平台的 MCP
  2. 收集配置信息：根据平台询问必要的配置（如 API Key、URL 等）
  3. 执行配置：使用 mcporter 命令添加 MCP 服务器
  4. 验证部署：测试 MCP 服务器是否正常工作
  5. 报告结果：展示部署结果和可用工具

常用配置参考

智谱 MCP (HTTP)
# 视觉理解
mcporter config add zhipu --url "https://open.bigmodel.cn/api/mcp/vision/mcp" --header "Authorization=Bearer YOUR_API_KEY"

# 联网搜索
mcporter config add web-search-prime --url "https://open.bigmodel.cn/api/mcp/web_search_prime/mcp" --header "Authorization=Bearer YOUR_API_KEY"

# 网页读取
mcporter config add web-reader --url "https://open.bigmodel.cn/api/mcp/web_reader/mcp" --header "Authorization=Bearer YOUR_API_KEY"

# GitHub 仓库
mcporter config add zread --url "https://open.bigmodel.cn/api/mcp/zread/mcp" --header "Authorization=Bearer YOUR_API_KEY"
Minimax MCP (STDIO)
# 需要先安装 uvx
which uvx || curl -LsSf https://astral.sh/uv/install.sh | sh

mcporter config add minimax --command "uvx" --args "minimax-coding-plan-mcp" --env "MINIMAX_API_KEY=YOUR_KEY,MINIMAX_API_HOST=https://api.minimaxi.com"
Gitea MCP (STDIO)
第一步：下载 Gitea MCP 二进制

访问 https://gitea.com/gitea/gitea-mcp/releases 下载对应平台的二进制文件。

根据 CPU 架构选择：

  • Apple Silicon (M1/M2/M3/M4): 选择 darwin-arm64
  • Intel Mac: 选择 darwin-amd64
  • Linux x86_64: 选择 linux-amd64
  • Linux ARM64: 选择 linux-arm64
第二步：安装二进制
# 下载后复制到系统路径
cp gitea-mcp /usr/local/bin/

# 赋予执行权限
chmod +x /usr/local/bin/gitea-mcp
第三步：配置 MCP
# 创建配置文件目录
mkdir -p ~/.config/mcp-deploy

# 创建 .env 文件（根据你的 Gitea 实例配置）
cat > ~/.config/mcp-deploy/gitea.env << 'EOF'
GITEA_TOKEN=your_token_here
GITEA_API_URL=http://your-gitea-instance:3000/api/v1
EOF

# 使用 mcporter 添加（根据你的 Agent 调整路径）
mcporter config add gitea --command "gitea-mcp" --env "GITEA_TOKEN=your_token,GITEA_API_URL=http://your-gitea-instance:3000/api/v1"

注意：更多配置选项请参阅 https://gitea.com/gitea/gitea-mcp

配置文件位置

  • MCP 配置：~/.config/mcporter.json 或项目级 config/mcporter.json
  • Gitea Token：可在 .env 文件中配置

注意事项

  • 如果用户没有提供必要的配置信息，先询问
  • 部署前检查目标 MCP 是否需要特殊的依赖（如 uvx、gitea-mcp 二进制）
  • 某些 MCP 需要内网访问（如自建 Gitea），确认网络可达
  • 部署后务必验证 MCP 是否正常工作
  • 如果 MCP 离线，尝试诊断问题（网络、内网、依赖等）
  • Gitea MCP 建议使用二进制方式安装，避免 npm 包的兼容性问题

评论

支持 Markdown