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 許可證。