Researchmcp

🚀 研究MCP

研究MCP是一个借助Perplexity AI的互联网研究服务，通过MCP协议（模型完成协议）提供强大的研究能力。它能让用户轻松获取各种主题的深入且最新信息。

🚀 快速开始

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

✨ 主要特性

• 通过Perplexity AI进行互联网研究
• 集成MCP协议以实现工具发现和调用
• 具备优雅错误处理和降级模式
• 通过环境变量配置
• 结构化日志记录

📦 安装指南

需求

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

配置

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

安装步骤

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

💻 使用示例

基础用法

API请求示例

以下是使用research工具进行研究查询的示例：

输入模式:

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

示例请求:

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

示例响应:

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

📚 详细文档

开发

项目结构

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

代码风格

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

./run_format.sh
./run_lint.sh

📄 许可证

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