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 文档以解决与协议相关的问题。