AI导哈

模型上下文协议服务器

一个轻量级的模型上下文协议服务器，支持专业搜索和社交搜索功能，可与Claude Code等MCP兼容客户端无缝集成。

  • by markusleucht
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 markusleucht/perplexity-mcp

使用说明

困惑MCP服务器

一个用于困惑人工智能的精益MCP（模型上下文协议）服务器，具有专业搜索和社交搜索功能。与Claude Code和其他MCP兼容客户端无缝集成。

特性

  • 专业搜索：通过流媒体支持和实时网络爬行进行深入研究
  • 社交搜索：将查询集中在X/Twitter、Reddit和其他社交平台上
  • 经济高效：流式处理可使用您的5美元API信用额度防止不必要的代币使用
  • 精益：最小依赖性（约100行核心代码）
  • 上下文感知：MCP协议实现了与Claude Code的自然集成

设置

一个命令设置（推荐）

chmod +x setup.sh && ./setup.sh

这将：

  • 自动检测您的Python安装
  • 安装所需的软件包(openai, python-dotenv)
  • 更新 .mcp.json 使用正确的Python路径
  • 验证设置

然后重新启动Claude Code。

手动设置

看 安装.md 有关详细的手动安装说明。

配置API密钥

  1. 从获取您的困惑API密钥 https://www.perplexity.ai/settings/api
  2. 创建一个 .env 文件：
    echo "PERPLEXITY_API_KEY=pplx-your-key-here" > .env

重要：从不承诺 .env 版本控制。它在里面 .gitignore 默认情况下。

自动安装功能

MCP服务器现在会在首次运行时自动安装缺失的依赖项。无需手动安装pip！

用法

Python模块

from src.perplexity_mcp import perplexity_search, perplexity_social

# Pro Search
result = perplexity_search("What are the latest AI trends?", search_type="pro")
print(result['content'])
print(f"Citations: {result['citations']}")

# Social-Focused Search
result = perplexity_social("What's trending about AI safety on Twitter?")
print(result['content'])

命令行测试

cd /Users/markus/perplexity
python src/perplexity_mcp.py

Claude代码集成

MCP服务器为Claude Code提供了两个工具：

1. perplexity_search

使用网络爬行进行深入研究。

参数：

  • query （字符串，必填）：搜索查询
  • search_type （字符串，默认值为“pro”）：“pro”、“auto”或“fast”
  • max_tokens （整数，默认值：1024）：响应长度（100-4000）

答复：

{
  "success": true,
  "content": "Search results...",
  "citations": ["url1", "url2"],
  "search_type": "pro"
}

2. perplexity_social

搜索社交媒体平台（X、Reddit等）。

参数：

  • query （string，必填）：社交媒体查询
  • max_tokens （整数，默认值：1024）：响应长度（100-4000）

答复：

{
  "success": true,
  "content": "Social media insights...",
  "citations": ["url1", "url2"],
  "search_focus": "social"
}

项目结构

/Users/markus/perplexity/
├── .env                      # Your API key (never commit)
├── .env.example              # Template for API keys
├── .gitignore                # Git ignore rules
├── README.md                 # This file
├── pyproject.toml            # Python project config
├── src/
│   └── perplexity_mcp.py    # MCP server implementation
└── docs/
    ├── guides/               # User-facing documentation
    │   ├── QUICKSTART.md     # Quick start guide
    │   ├── USER_GUIDE.md     # End user examples & tips
    │   ├── DEVELOPER_GUIDE.md # Technical API reference
    │   ├── PHARMA_RESEARCH.md # Pharma skill guide
    │   └── TROUBLESHOOTING.md # Common issues
    ├── tools/                # Tool manifests
    │   ├── mcp-servers.md    # MCP server capabilities
    │   ├── skills.md         # Installed skills
    │   └── packages.md       # Package inventory
    ├── specs/                # Mirrored specifications
    └── reports/              # Generated research reports

文档

快速开始

→ QUICKSTART.md -2分钟设置 → docs/guides/QUICKSTART.md -综合指南

用户文档

→ docs/guides/USER_GUIDE.md -示例、提示、输出格式 → 文档/指南/PHARMA_RESEARCH.md -德国医药市场研究

开发者文档

→ docs/guides/DEVELO_GUIDE.md -API参考，参数 → 安装.md -详细的安装说明

支持

→ docs/guides/TROUBLESHOOTING.md -常见问题和解决方案 → CLAUDE.md -系统指南和渐进式披露

API成本

使用您的5美元API信用额度：

  • 专业搜索：每次查询约0.20-0.50美元（深入分析）
  • 社交搜索：每个查询约0.10-0.20美元（重点结果）
  • 估计：使用Pro tier每月查询25-50次

监控您的使用情况 困惑仪表板.

局限性

  • API访问需要使用专业版
  • 费率限制适用于每个计划（查看仪表板）
  • Pro Search已启用流媒体功能，以优化令牌使用
  • 社交搜索仅限于源参数；不能直接刮擦

未来的增强功能

  • 实时更新的流式响应处理
  • 响应缓存以减少API调用
  • 批量查询支持
  • 自定义系统提示
  • 与其他API（Tavily等）集成

故障排除

错误：“PERPLEXITY_API_KEY未设置”

错误：“超出速率限制”

未返回任何结果

  • 验证您的搜索查询是否有效
  • 尝试不同的 search_type （“专业”vs“汽车”）
  • 检查您的API密钥是否具有活动信用

许可证

麻省理工学院

相关 MCP