Deploy and Host Perplexity MCP Server on Railway

用你自己的 Perplexity 订阅额度，自建一套 OpenAI 兼容 API + MCP 服务，并自带号池管理面板。

Self-host an OpenAI-compatible API and MCP server on top of your own Perplexity subscription, with a built-in multi-account pool dashboard.

本项目是 escapeWu/perplexity-ai 的 fork，已针对 Railway 适配：Dockerfile 构建、/ready 健康检查、失败自动重启、管理面板中英文切换、 reasoning_effort 兼容。

About Hosting Perplexity MCP Server

部署后你会得到一个单容器服务：

对外提供 /v1/models、/v1/chat/completions（OpenAI 兼容）与 /mcp（MCP 协议）
浏览器打开 /admin/ 是号池管理面板（支持中英文切换），/playground/ 是在线调试台
服务监听 8000 端口，健康检查路径 /ready
模版已创建持久卷挂载到 /app/data，用于保存账号配置、日志、模型缓存与会话数据库

它不做模型推理，而是复用你浏览器登录 Perplexity 的会话 cookie，把网页版内部接口翻译成标准协议。消耗的是订阅里的网页版额度（Pro Search、Deep Research），不是官方 API 额度。

Why Deploy Perplexity MCP Server

想把 Perplexity 接到 Cherry Studio、LobeChat、NextChat、opencodex、Codex 等客户端里统一使用
想让自己支持 MCP 的编码工具获得实时联网检索与深度调研能力
想用多个 Perplexity 账号做轮询与高可用，而不是手动切来切去
不想把 cookie 交给任何第三方在线服务，服务跑在你自己账号的 Railway 项目里

Common Use Cases

在 OpenAI 兼容客户端里使用 Perplexity 的 GPT / Claude / Gemini / Grok 等联网模型
给 Claude Code、Codex 之类的 MCP 客户端接上 perplexity_ask_v2（实时搜索）与 perplexity_research_v2（深度调研）
多账号号池：加权调度、失败退避、Cookie 每 6 小时自动续期，失效时可选 Telegram 提醒
通过管理面板查看每个账号的权重、请求计数、失败次数与实时日志

Dependencies for Perplexity MCP Server

Deployment Dependencies

依赖	说明
Perplexity 订阅账号	至少一个；Pro 账号会解锁十几个模型，Max 账号可额外使用 Max 专属模型
浏览器登录态	需要从已登录 perplexity.ai 的浏览器里复制会话 cookie
Railway 账号	用于托管服务与持久卷
两个密钥	`MCP_TOKEN`（接口认证）与 `PPLX_ADMIN_TOKEN`（管理面板），随机字符串即可

部署时必填的变量

变量	说明
`MCP_TOKEN`	调用 `/v1/*` 与 MCP 接口的密钥，随机字符串即可（`openssl rand -hex 32`）
`PPLX_ADMIN_TOKEN`	登录 `/admin/` 管理面板的密钥，与上面那个不要混用

部署后三步

1. 生成公网域名 服务 → Settings → Networking → Generate Domain，目标端口填 8000（不是 8080）。

2. 验证服务

D=https://你的域名
curl -s $D/health      # {"status":"healthy",...}
curl -s $D/ready       # {"status":"ready"}

3. 绑定 Perplexity 账号 打开 https://你的域名/admin/，用 PPLX_ADMIN_TOKEN 登录，点 NEW TOKEN：

标识：任意好认的名字
Cookies：登录 perplexity.ai → F12 → Network → 刷新 → 点任意发往 www.perplexity.ai 的请求 → Request Headers → 复制 cookie: 后面那一整串

面板会自动挑出 __Secure-pplx.session.UUID 和 __Host-pplx-last-active-account，丢弃 cf_clearance、__cf_bm 等临时 cookie。绑定完成后 /v1/models 会从 1 个降级模型变成你订阅可用的全部模型。

客户端接入

OpenAI 兼容:  https://你的域名/v1      密钥 = MCP_TOKEN
MCP:          https://你的域名/mcp     头部 = Authorization: Bearer MCP_TOKEN

注意事项

不支持 function calling / 工具调用，适合问答、检索与调研，不适合当代码 agent 的主力模型。
本项目通过逆向网页版接口实现，违反 Perplexity 使用条款，存在限流或封号风险。
cookie 等同账号登录态，卷里的配置文件是明文存储，请勿分享给他人。
仅供个人学习与研究使用。