MCP Skill - Model Context Protocol 使用技能

概述

本技能用于配置和管理 MCP (Model Context Protocol) 服务器，让 AI 能够调用外部工具。

---

1. 安装 mcporter

npm install -g clawhub

确保 uvx 可用：

which uvx
# 如果没有：
curl -LsSf https://astral.sh/uv/install.sh | sh

---

2. 配置 MCP 服务器

2.1 创建配置文件

mkdir -p ~/.config/mcporter

2.2 MiniMax MCP 配置示例

{
  "mcpServers": {
    "MiniMax": {
      "type": "stdio",
      "command": "uvx",
      "args": ["minimax-coding-plan-mcp"],
      "env": {
        "MINIMAX_API_KEY": "你的API密钥",
        "MINIMAX_MCP_BASE_PATH": "/tmp/mcporter-output",
        "MINIMAX_API_HOST": "https://api.minimaxi.com"
      }
    }
  }
}

保存到 ~/.config/mcporter/mcporter.json

---

3. 验证配置

npx mcporter --config ~/.config/mcporter/mcporter.json list

成功会显示：

✔ Listed 1 server (1 healthy)

---

4. 调用工具

4.1 视觉理解

npx mcporter --config ~/.config/mcporter/mcporter.json call MiniMax.understand_image \
  "prompt: 描述图片内容" \
  "image_source: /path/to/image.jpg"

4.2 网络搜索

npx mcporter --config ~/.config/mcporter/mcporter.json call MiniMax.web_search \
  "query: 搜索内容"

---

5. 常用 MCP 服务器

MCP 包名	功能
minimax-coding-plan-mcp	视觉理解、网络搜索
linear-mcp	Linear 项目管理
filesystem-mcp	文件系统操作
github-mcp	GitHub 操作

---

6. 常见问题

6.1 MCP 服务器离线

• 检查 API Key 是否正确
• 检查网络连接
• 确认 MCP 包名正确

6.2 参数错误

查看可用参数：

npx mcporter list <服务器名> --schema

6.3 权限问题

• 确保目录存在
• 确保有写入权限

---

最后更新: 2026-02-24