mcpField
M
mcp-deploy

mcp-deploy

github.com/zrongAgent workflows1338 installsUpdated 2w ago
Repository

About mcp-deploy

An agent skill that guides deployment and configuration of MCP servers using mcporter. It covers supported HTTP and STDIO setups, required credentials or dependencies, and post-deployment checks.

Key features

  1. 01Guided server and credential selection
  2. 02HTTP and STDIO configuration examples
  3. 03Dependency and network checks
  4. 04Post-deployment verification

Use cases

  1. 01Adding a Zhipu HTTP server
  2. 02Configuring Minimax over STDIO
  3. 03Setting up a Gitea server
  4. 04Diagnosing an unavailable MCP server

MCP support

Guides the agent through adding MCP servers with mcporter, collecting required settings, and checking that deployment works. Examples cover HTTP and STDIO configurations.

Install

Copy the command and run it in a terminal.

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

After installing, type/mcp-deployin Claude Code to confirm it loaded.

Details

From the project 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 包的兼容性问题

Comments

Markdown supported