Gopluto Ai MCP

🚀 GoPluto MCP — 在任何提示中获取最新的服务知识和代码片段

GoPluto MCP 允许 AI 编码助手直接从 GoPluto 中提取最新的服务/供应商知识、路由规则和可直接粘贴的代码片段，让这些内容直接呈现在你的提示信息中。

---

✨ 主要特性

❌ 没有 GoPluto 的情况

• ❌ 当你真正需要专家时，无法保证能找到合适的专家。
• ❌ 虚构的供应商和无效的流程会浪费时间。
• ❌ 频繁在不同人员之间切换上下文会降低你的工作效率。

✅ 有 GoPluto 的情况

在你的提示信息中添加 use gopluto（或者一次性设置规则），助手就会获取实时的 GoPluto 上下文信息：

• 直接将最新的、经过验证的供应商知识提取到你的提示信息中。
• 即时提供供应商匹配提示和过滤器。
• 提供最小化的有效负载和代码片段，让你在几分钟内就能联系到专家。

示例

Draft a WhatsApp onboarding flow that asks for experts within minutes. use gopluto

Show me the minimal payload to create a Service Request and start matching experts in under 60 seconds. use gopluto

---

📦 安装指南

要求

• 任何支持 MCP 的客户端（Cursor、Claude Code、VS Code、Windsurf、Zed 等）。
• GoPluto API 密钥（保留在客户端）。
• 能够访问 https://api.gopluto.ai/mcp 网络。

认证头：gopluto-api-key: YOUR_API_KEY

⚠️ 重要提示

如果你的客户端无法向远程服务器附加请求头，可以使用附带的本地标准输入输出代理（main.py）为你添加请求头。

Cursor

一键安装（远程 HTTP）

手动安装（远程）

{
  "mcpServers": {
    "gopluto": {
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

本地安装（标准输入输出代理）

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {
        "GOPLUTO_MCP_URL": "https://api.gopluto.ai/mcp",
        "GOPLUTO_AUTH_HEADER": "gopluto-api-key",
        "GOPLUTO_API_KEY": "YOUR_API_KEY",
        "GOPLUTO_TRANSPORT": "sse"
      }
    }
  }
}

Claude Code (CLI)

远程安装

claude mcp add --transport http gopluto https://api.gopluto.ai/mcp \
  --header "gopluto-api-key: YOUR_API_KEY"

本地安装

claude mcp add gopluto -- uv run python3 /ABSOLUTE/PATH/TO/gopluto-mcp/main.py

Windsurf

远程安装

{
  "mcpServers": {
    "gopluto": {
      "serverUrl": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

本地安装

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

VS Code (Copilot Chat MCP)

远程安装

"mcp": {
  "servers": {
    "gopluto": {
      "type": "http",
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

本地安装

"mcp": {
  "servers": {
    "gopluto": {
      "type": "stdio",
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Cline

从市场安装

在市场中搜索 GoPluto 并点击安装。

手动安装（远程）

{
  "mcpServers": {
    "gopluto": {
      "url": "https://api.gopluto.ai/mcp",
      "type": "streamableHttp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

Zed

{
  "context_servers": {
    "GoPluto": {
      "command": {
        "path": "uv",
        "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
      }
    }
  }
}

Augment Code

通过 UI 安装

进入 UI → 设置 → 工具 → + 添加 MCP，在命令框中输入：

uv run python3 /ABSOLUTE/PATH/TO/gopluto-mcp/main.py

手动安装

"augment.advanced": {
  "mcpServers": [
    {
      "name": "gopluto",
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  ]
}

Roo Code

远程安装

{
  "mcpServers": {
    "gopluto": {
      "type": "streamable-http",
      "url": "https://api.gopluto.ai/mcp",
      "headers": { "gopluto-api-key": "YOUR_API_KEY" }
    }
  }
}

本地安装

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Gemini CLI

远程安装

{
  "mcpServers": {
    "gopluto": {
      "httpUrl": "https://api.gopluto.ai/mcp",
      "headers": {
        "gopluto-api-key": "YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

本地安装

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Claude Desktop

远程安装

进入设置 → 连接器 → 添加自定义连接器，URL 填写 https://api.gopluto.ai/mcp，请求头填写 gopluto-api-key: YOUR_API_KEY。

本地安装

进入开发者设置，编辑 claude_desktop_config.json 文件：

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {
        "GOPLUTO_MCP_URL": "https://api.gopluto.ai/mcp",
        "GOPLUTO_AUTH_HEADER": "gopluto-api-key",
        "GOPLUTO_API_KEY": "YOUR_API_KEY",
        "GOPLUTO_TRANSPORT": "sse"
      }
    }
  }
}

Opencode

远程安装

"mcp": {
  "gopluto": {
    "type": "remote",
    "url": "https://api.gopluto.ai/mcp",
    "headers": { "gopluto-api-key": "YOUR_API_KEY" },
    "enabled": true
  }
}

本地安装

"mcp": {
  "gopluto": {
    "type": "local",
    "command": ["uv","run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
    "enabled": true
  }
}

JetBrains AI Assistant

进入设置 → 工具 → AI 助手 → 模型上下文协议 (MCP) → + 添加 → 以 JSON 格式添加，输入以下内容：

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Kiro

{
  "mcpServers": {
    "GoPluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

Trae

远程安装

{
  "mcpServers": {
    "gopluto": { "url": "https://api.gopluto.ai/mcp" }
  }
}

本地安装

{
  "mcpServers": {
    "gopluto": {
      "command": "uv",
      "args": ["run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Bun / Deno (本地)

Bun

{
  "mcpServers": {
    "gopluto": {
      "command": "bunx",
      "args": ["uv","run","python3","/ABSOLUTE/PATH/TO/gopluto-mcp/main.py"]
    }
  }
}

Deno

{
  "mcpServers": {
    "gopluto": {
      "command": "deno",
      "args": ["run","--allow-run","--allow-env","--allow-net","/ABSOLUTE/PATH/TO/gopluto-mcp/deno_shim.ts"]
    }
  }
}

Docker (本地 HTTP)

Dockerfile

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt main.py ./
RUN pip install --no-cache-dir -r requirements.txt
ENV GOPLUTO_MCP_URL=https://api.gopluto.ai/mcp \
    GOPLUTO_AUTH_HEADER=gopluto-api-key \
    GOPLUTO_TRANSPORT=sse
EXPOSE 12006
CMD ["python","main.py","--mode","http","--host","0.0.0.0","--port","12006"]

运行命令：

docker build -t gopluto-mcp .
docker run --rm -p 12006:12006 -e GOPLUTO_API_KEY=YOUR_API_KEY gopluto-mcp

将你的客户端指向 http://localhost:12006。

Windows 注意事项

如果路径或引号使用比较复杂，可以使用 cmd /c 或 PowerShell；建议在 command 和 args 中使用绝对路径。

---

🔧 可用工具（示例）

• resolve-gopluto-id – 将包/服务名称解析为 GoPluto ID。
• get-gopluto-docs – 获取 GoPluto ID 对应的文档/代码片段。
• search-providers – 根据技能、地理位置、预算等条件查询供应商。
• create-service-request – 最小化有效负载助手。

(你上游服务器的工具列表可能会有所变化；可以使用客户端的工具检查器来查看最新列表。)

---

🛟 使用建议

添加自动使用 GoPluto 的规则

Always use gopluto when I ask for service matching, onboarding flows, or API payloads.
Automatically call GoPluto MCP tools to resolve IDs and fetch snippets.

HTTPS 代理

可以使用标准的 HTTPS_PROXY / https_proxy 环境变量。

---

💻 使用示例

本地代理开发

uv pip install -r requirements.txt
export GOPLUTO_API_KEY="YOUR_REAL_KEY"
uv run python3 main.py               # stdio (default)
# or:
uv run python3 main.py --mode http --port 12006

对远程服务器进行冒烟测试

curl -X POST "https://api.gopluto.ai/mcp" \
  -H "Content-Type: application/json" \
  -H "gopluto-api-key: $GOPLUTO_API_KEY" \
  -d '{"jsonrpc":"2.0","id":"1","method":"initialize","params":{"protocolVersion":"2025-06-18"}}'

---

🚨 故障排除

• 401/403 错误 → gopluto-api-key 错误或缺失。
• 客户端无法添加请求头 → 使用本地标准输入输出代理。
• TLS 问题 → 为 Python 设置 SSL_CERT_FILE。
• Node 模块未找到 → 建议使用 Python 代理（无需 Node）。

---

📄 许可证

本项目采用 MIT 许可证。