ResearchMCP

一个使用 Perplexity AI 进行互联网研究的模型补全协议 (MCP) 服务。

概述

ResearchMCP 是一个通过 MCP 协议提供互联网研究能力的服务。它暴露了一个 "research" 工具，允许查询 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

API

Research Tool

名称: research

输入 Schema:

{
  "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 文件。