ResearchMCP

🚀 研究MCP

研究MCP是一个借助Perplexity AI的互联网研究服务，它通过MCP协议（模型完成协议），为用户提供深入且最新的各种主题信息查询服务，帮助用户高效获取所需知识。

🚀 快速开始

研究MCP是一个通过MCP协议提供互联网研究能力的服务。它公开了一个“研究”工具，允许通过查询Perplexity AI的API获取深入且最新的各种主题信息。

✨ 主要特性

• 通过Perplexity AI进行互联网研究，确保获取信息的全面性和时效性。
• 集成MCP协议以实现工具发现和调用，提升服务的灵活性和可扩展性。
• 具备优雅错误处理和降级模式，保障服务的稳定性和可靠性。
• 通过环境变量配置，方便用户根据自身需求进行定制。
• 结构化日志记录，便于后续的问题排查和性能分析。

📦 安装指南

需求

• Go 1.18或更高版本
• Perplexity AI API密钥

配置

服务通过环境变量进行配置：

| 变量名 | 描述 | 是否必填 | 默认值 | |------------------|--------------------------|----------|---------------| | PERPLEXITY_API_KEY | Perplexity AI的API密钥 | 是 | - | | PERPLEXITY_MODEL | 使用的研究模型 | 否 | sonar-medium-online | | PERPLEXITY_TIMEOUT | API请求超时时间（秒） | 否 | 90 | | PERPLEXITY_MAX_RETRIES | 最大重试次数 | 否 | 2 | | PERPLEXITY_INITIAL_BACKOFF | 初始回退时间（秒） | 否 | 1 | | PERPLEXITY_MAX_BACKOFF | 最大回退时间（秒） | 否 | 10 |

安装步骤

1. 设置所需的环境变量（可以使用.env文件）
2. 构建并运行服务：

go build
./ResearchMCP

示例 .env 文件

PERPLEXITY_API_KEY=your_api_key_here
PERPLEXITY_MODEL=sonar-medium-online
PERPLEXITY_TIMEOUT=120
PERPLEXITY_MAX_RETRIES=3
PERPLEXITY_INITIAL_BACKOFF=2
PERPLEXITY_MAX_BACKOFF=15

💻 使用示例

基础用法

以下是调用research工具的示例请求：

{
  "name": "research",
  "arguments": {
    "query": "量子计算的当前状态是什么？"
  }
}

示例响应：

{
  "content": [
    {
      "type": "text",
      "text": "关于量子计算的综合研究报告...\n\n来源:\n- https://example.com/source1\n- https://example.com/source2"
    }
  ]
}

📚 详细文档

API - 研究工具

名称: research

输入模式:

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string", 
      "description": "研究查询或问题"
    }
  },
  "required": ["query"]
}

开发

项目结构

• main.go: 应用程序入口点
• config.go: 配置处理
• logger.go: 日志记录基础设施
• perplexity.go: Perplexity API集成
• structs.go: 数据结构
• context.go: 上下文处理

代码风格

使用提供的脚本运行格式化和linting：

./run_format.sh
./run_lint.sh

📄 许可证

该项目根据MIT许可证发布，具体内容见LICENSE文件。