Gopher MCP Server

🚀 Gopher MCP 服務器

Gopher MCP 服務器是一個模型上下文協議（MCP）服務器，可用於訪問 Gopher AI API。藉助該服務器，MCP 客戶端能夠通過 Gopher AI 平臺搜索數據。

✨ 主要特性

• 推特搜索：使用自然語言查詢搜索推特帖子。
• MCP 集成：與模型上下文協議客戶端完全兼容。
• 結果可配置：可調整搜索結果的最大數量。
• 錯誤處理：具備全面的錯誤處理和報告機制。
• 異步處理：通過輪詢處理異步 API 響應。

📦 安裝指南

從源代碼安裝

1. 克隆倉庫：

git clone https://github.com/gopher-lab/gopher-mcp-server.git
cd gopher-mcp-server

2. 構建服務器：

go build -o gopher-mcp-server ./data

使用 Docker 安裝

docker build -t gopher-mcp-server .

📚 詳細文檔

配置

環境變量

• GOPHER_API：必需 - 你的 Gopher AI API 密鑰。
• MAX_RESULTS：可選 - 返回的最大搜索結果數量（默認值：15）。

配置示例

export GOPHER_API="your-gopher-api-key-here"
export MAX_RESULTS="20"

使用方法

運行服務器

# 使用二進制文件
./gopher-mcp-server

# 使用 Docker
docker run -e GOPHER_API="your-api-key" gopher-mcp-server

MCP 客戶端配置

將此服務器添加到你的 MCP 客戶端配置中：

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "gopher-twitter": {
      "command": "./gopher-mcp-server",
      "env": {
        "GOPHER_API": "your-gopher-api-key-here",
        "MAX_RESULTS": "15"
      }
    }
  }
}

Cline 配置

{
  "mcpServers": {
    "gopher-twitter": {
      "command": "docker",
      "args": ["run", "--rm", "-e", "GOPHER_API=your-api-key", "gopher-mcp-server"],
      "env": {
        "GOPHER_API": "your-gopher-api-key-here"
      }
    }
  }
}

可用工具

search_twitter

使用 Gopher AI API 搜索推特帖子。

參數：

• query（字符串）：要執行的搜索查詢。

返回值：

• tweets（數組）：與搜索查詢匹配的推特帖子數組。
• error（字符串，可選）：如果搜索失敗，返回錯誤消息。

使用示例：

{
  "name": "search_twitter",
  "arguments": {
    "query": "artificial intelligence trends 2024"
  }
}

響應示例：

{
  "tweets": [
    {
      "ID": "tweet_123",
      "Content": "Exciting developments in AI this year...",
      "Metadata": {...},
      "Score": 0.95
    }
  ],
  "error": null
}

API 詳情

推特帖子結構

響應中的每個推特帖子包含以下內容：

• ID：帖子的唯一標識符。
• Content：推文的文本內容。
• Metadata：關於帖子的附加元數據。
• Score：搜索查詢的相關性得分。

錯誤處理

服務器處理各種錯誤場景：

• API 錯誤：無效的 API 密鑰、速率限制、服務不可用。
• 網絡錯誤：連接超時、網絡故障。
• 處理錯誤：搜索超時、無效響應。

錯誤消息會在響應的 error 字段中返回。

開發

構建

# 構建服務器
make build

# 運行測試
make test

# 構建 Docker 鏡像
make docker-build

依賴項

• github.com/modelcontextprotocol/go-sdk：Go 語言的 MCP SDK。
• github.com/tmc/langchaingo：語言鏈實用工具。

故障排除

常見問題

1. 未設置 API 密鑰
   • 確保已設置 GOPHER_API 環境變量。
   • 驗證 API 密鑰是否有效且具有適當的權限。
2. 搜索超時
   • 服務器最多輪詢 30 次以獲取結果（總共 60 秒）。
   • 檢查 Gopher AI 服務是否存在延遲。
3. 未返回結果
   • 驗證搜索查詢是否有效。
   • 檢查是否有符合你條件的帖子。
   • 確保 API 密鑰有權限訪問推特數據。
4. MCP 客戶端連接問題
   • 驗證服務器二進制文件是否可執行。
   • 檢查 MCP 客戶端配置是否正確。
   • 確保服務器正在運行且可訪問。

調試

通過設置日誌級別啟用詳細日誌記錄：

export LOG_LEVEL=debug
./gopher-mcp-server

貢獻代碼

1. 分叉倉庫。
2. 創建功能分支。
3. 進行更改。
4. 如有必要，添加測試。
5. 提交拉取請求。

📄 許可證

本項目採用 Apache 許可證 2.0。有關詳細信息，請參閱 LICENSE 文件。

支持

若有問題或疑問：

• 在 GitHub 上創建問題。
• 查閱 Gopher AI 文檔以獲取與 API 相關的問題解答。
• 查看 MCP 文檔以解決與協議相關的問題。