ResearchMCP

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 工具

名称：research

输入架构：

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The research query or question"
    }
  },
  "required": ["query"]
}

请求示例：

{
  "name": "research",
  "arguments": {
    "query": "What is the current state of quantum computing?"
  }
}

响应示例：

{
  "content": [
    {
      "type": "text",
      "text": "Comprehensive research report on quantum computing...\n\nSources:\n- https://example.com/source1\n- https://example.com/source2"
    }
  ]
}

开发

项目结构

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

代码风格

使用提供的脚本运行格式化和 lint 检查：

./run_format.sh
./run_lint.sh

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。