Gopher MCP Server

Gopher MCP 服务器

一个模型上下文协议（MCP）服务器，提供对Gopher AI API的访问。该服务器允许MCP客户端通过Gopher AI平台搜索数据。

特点/功能

• Twitter搜索使用自然语言查询搜索Twitter帖子
• MCP集成与模型上下文协议客户端完全兼容
• 可配置的结果可调整的最大搜索结果数量
• 错误处理全面的错误处理和报告
• 异步处理处理异步API响应，采用轮询方式

先决条件

• Go 1.24.7 或更高版本
• Gopher AI API密钥
• 与MCP兼容的客户端（例如，Claude Desktop、Cline等）

安装

来自源（或“来源”）

1. 克隆仓库：

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

1. 构建服务器：

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"

用法

运行服务器

# Using the binary
./gopher-mcp-server

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

MCP 客户端配置

将此服务器添加到您的MCP客户端配置中：

Claude 桌面版（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"
      }
    }
  }
}

可用工具

搜索推特

使用Gopher AI API搜索Twitter帖子。

参数：

• 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详情

Twitter帖子结构

响应中的每条Twitter帖子都包含：

• ID帖子的唯一标识符
• Content这条推文的文本内容
• Metadata关于帖子的额外元数据
• Score搜索查询的相关性得分

错误处理

服务器处理各种错误场景：

• API 错误无效的API密钥，速率限制，服务不可用
• 网络错误连接超时，网络故障
• 处理错误搜索超时，响应无效

错误信息会返回在 error 响应字段。

发展

建筑

# Build the server
make build

# Run tests
make test

# Build Docker image
make docker-build

依赖项

• github.com/modelcontextprotocol/go-sdkGo语言的MCP SDK
• github.com/tmc/langchaingo语言链实用工具

故障排除

常见问题

1. API密钥未设置

- 确保 GOPHER_API 环境变量已设置 - 验证API密钥是否有效且具有适当的权限

1. 搜索超时

- 服务器最多轮询30次以获取结果（总计60秒） - 检查Gopher AI服务是否出现延迟

1. 未返回结果

- 验证搜索查询是否有效 - 检查是否有符合您标准的帖子 - 确保API密钥有权访问Twitter数据

1. MCP客户端连接问题

- 验证服务器二进制文件是否可执行 - 检查MCP客户端配置是否正确 - 确保服务器正在运行且可访问

调试

通过设置日志级别来启用详细日志记录：

export LOG_LEVEL=debug
./gopher-mcp-server

做出贡献

1. 为仓库创建分支（或：克隆仓库）
2. 创建一个特性分支
3. 做出你的更改
4. 如适用，请添加测试
5. 提交拉取请求

许可证

此项目遵循Apache License 2.0协议授权。详情请参见LICENSE文件。

支持

对于问题和疑问：

• 在GitHub上创建一个问题
• 请查阅Gopher AI的文档以获取有关API的问题解答
• 审查MCP文档中的协议相关问题