AI导哈

智能网页搜索服务器

Sonar Pro Search MCP Server是一个生产就绪的模型上下文协议服务器，通过Perplexity的Sonar Pro API（通过OpenRouter）为Claude提供高级网页搜索功能。

  • by TheHerq
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 TheHerq/sonar-mcp-server

使用说明

🌐 Sonar Pro搜索MCP服务器

通过OpenRouter使用Perplexity Sonar Pro进行智能网络搜索的专业MCP服务器

概述

Sonar Pro Search MCP服务器是一款可用于生产的模型上下文协议服务器，通过Perplexity的Sonar Pro API（通过OpenRouter）为Claude提供高级网络搜索功能。

主要特点

✅ 实时信息 -访问当前网络数据
✅ 智能搜索 -基于人工智能的自动引用搜索
✅ 4专用工具 -从快速搜索到深入研究
✅ Docker就绪 -易于安装和部署
✅ 生产质量 -错误处理、限制、日志记录
✅ 证据充分的 -完整的波兰语和英语文档

快速开始

需求

  • Docker桌面已安装并正在运行
  • OpenRouter API密钥（可用的免费层）
  • Claude桌面（用于集成）

启动的三个步骤

# 1. Setup - check environment and create .env
./sonar_docker.sh setup

# 2. Build - build Docker image
./sonar_docker.sh build

# 3. Start - run server
./sonar_docker.sh start

就是这样！ 🎉 服务器已准备好使用。

可用工具

1. sonar_search -基本网络搜索

快速、标准或详细的引用搜索。

2. sonar_ask -对话问答

用可选的上下文提问，以获得个性化的答案。

3. sonar_research -深入研究

包含多达6000个代币和重点领域的全面研究。

4. sonar_reason -复杂推理

对技术决策和复杂问题进行逐步分析。

配置

获取API密钥

  1. 访问：https://openrouter.ai/keys
  2. 登录（GitHub/谷歌）
  3. 创建密钥
  4. 复制密钥（以开头 sk-or-v1-...)

配置环境

# Copy example
cp .env.example .env

# Edit and add your key
nano .env

Claude桌面设置

macOS：

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

窗户：

%APPDATA%\Claude\claude_desktop_config.json

添加配置：

{
  "mcpServers": {
    "sonar-pro-search": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "sonar-mcp-server",
        "python",
        "sonar_mcp_server.py"
      ],
      "env": {}
    }
  }
}

重新启动克劳德桌面。

管理命令

# Server status
./sonar_docker.sh status

# View logs
./sonar_docker.sh logs

# Restart
./sonar_docker.sh restart

# Test health
./sonar_docker.sh test

# Help
./sonar_docker.sh help

文档

  • README_PL.md -完整的波兰语文档
  • DOCKER_QUICK_START_PL.md -5分钟快速启动（波兰语）
  • OpenRouter文档: https://openrouter.ai/docs
  • MCP文件: https://modelcontextprotocol.io/

故障排除

服务器无法启动

# Check logs
./sonar_docker.sh logs

# Verify Docker is running
docker ps

API密钥错误

编辑 .env 并验证您的OpenRouter API密钥：

./sonar_docker.sh config

费率限制（429）

  • 等几分钟
  • 考虑升级OpenRouter计划
  • 使用更低 max_tokens

克劳德看不到工具

  1. 检查服务器状态： ./sonar_docker.sh status
  2. 验证中的配置 claude_desktop_config.json
  3. 完全重新启动克劳德桌面

成本

免费等级：

  • 10个请求/分钟
  • 非常适合测试和个人使用

付费计划：

  • 每次请求约0.001-0.003美元
  • 更高的利率限制
  • 请参阅：https://openrouter.ai/models

安全

✅ 永不承诺 .env 文件
✅ 使用 .env.example 作为模板
✅ 定期旋转按键
✅ 在OpenRouter仪表板上监控使用情况

许可证

MIT许可证-请参阅 许可证 详情

支持

  • OpenRouter支持：https://openrouter.ai/
  • MCP文件：https://modelcontextprotocol.io/
  • Docker帮助：https://docs.docker.com/

准备好搜索网络了！ 🚀🌐✨

有关波兰语的完整文档，请参阅 README_PL.md

相关 MCP