perplexity-polza-mcp-server

通过 Polza.ai 使用 Perplexity MCP 服务

mcp-name: io.github.ivanantigravity-lgtm/perplexity-polza-mcp-server

适用于 Claude Desktop 和 Claude Code 的 MCP 服务，可通过聚合器 Polza.ai 调用 Perplexity 模型（Sonar、Sonar Pro、Sonar Reasoning、Sonar Deep Research）。

功能

• perplexity_model_guide — 根据任务选择模型的速查指南
• perplexity_ask — 向 Perplexity 提出常规问题
• perplexity_research — 结合网络搜索进行更深入的研究
• list_perplexity_models — 列出 Polza 目录中可用的 perplexity/* 模型

安装要求

• Claude Desktop 或 Claude Code（或任何其他 MCP 客户端）
• uv（通过一条命令安装，见下文）
• Python 3.11+
• POLZA_AI_API_KEY — 在 polza.ai/dashboard/api-keys 获取密钥

安装 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

2 分钟安装（通过 PyPI + uvx）

这是最简单的方式：无需克隆，uvx 会自动从 PyPI 下载软件包。

Claude Code / VS Code

在项目根目录创建 .mcp.json 文件：

{
  "mcpServers": {
    "perplexity-polza": {
      "command": "uvx",
      "args": ["perplexity-polza-mcp-server@latest"],
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

重启 Claude Code 即可。

Claude Desktop（macOS）

打开文件 ~/Library/Application Support/Claude/claude_desktop_config.json 并添加：

{
  "mcpServers": {
    "perplexity-polza": {
      "command": "uvx",
      "args": ["perplexity-polza-mcp-server@latest"],
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

重启 Claude Desktop。

Claude Desktop（Windows）

文件：%APPDATA%\Claude\claude_desktop_config.json。内容与 macOS 相同。

如何检查是否正常运行

重启 Claude 后，请它：

通过 polza 显示可用的 Perplexity 模型

Claude 应调用工具 list_perplexity_models 并返回列表。

如何选择模型

• Sonar — 快速搜索并回答。适用于新闻、事实、问答和简短摘要。
• Sonar Pro — 结构更严谨，适用于比较和后续提问。
• Sonar Pro Search — 搜索更深入，搜索步骤更多。
• Sonar Reasoning Pro — 不只是查找信息，还会进行分析并得出结论。
• Sonar Deep Research — 全面研究，适用于市场扫描和长篇报告。

可以通过环境变量 PERPLEXITY_MODEL 和 PERPLEXITY_RESEARCH_MODEL 切换默认模型 — 完整列表见下文。

环境变量

变量	必填	默认值	描述
POLZA_AI_API_KEY	是	—	polza.ai 的密钥
POLZA_BASE_URL	否	https://polza.ai/api/v1	chat completions 的 Base URL（包含 /v1 是预期行为；该 endpoint 兼容 OpenAI）
PERPLEXITY_MODEL	否	perplexity/sonar	perplexity_ask 使用的模型
PERPLEXITY_RESEARCH_MODEL	否	perplexity/sonar-deep-research	perplexity_research 使用的模型
LOG_LEVEL	否	INFO	—

本地开发

git clone https://github.com/ivanantigravity-lgtm/perplexity-polza-mcp-server.git
cd perplexity-polza-mcp-server
uv sync
POLZA_AI_API_KEY=your_key uv run python -m perplexity_polza_mcp_server.server

要在 Claude 中从源代码进行本地连接：

{
  "mcpServers": {
    "perplexity-polza-local": {
      "command": "uv",
      "args": ["run", "python", "-m", "perplexity_polza_mcp_server.server"],
      "cwd": "/absolute/path/to/perplexity-polza-mcp-server",
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

实现细节

• Chat completions：POST https://polza.ai/api/v1/chat/completions（兼容 OpenAI 的格式）
• 模型目录：GET https://polza.ai/api/v1/models/catalog

仓库中的重要文件

• pyproject.toml — 软件包元数据和 entry points
• server.json — MCP Registry 描述文件
• fastmcp.json — FastMCP 本地配置
• .github/workflows/publish-pypi.yml — 通过 GitHub Actions 发布到 PyPI

许可证

MIT。