模型协议服务器

一个实现Model Context Protocol的服务器,通过OpenRouter API提供Perplexity的模型访问能力,支持多种查询和研究任务。

  • by elct9620
  • TypeScript
  • 本地部署
  • 8 星标
  • 更新于
在 GitHub 查看 elct9620/perplexity-ask-openrouter

使用说明

困惑询问OpenRouter

一种模型上下文协议(MCP)服务器实现,使OpenRouter可用于困惑询问。

概述

这个项目的灵感来自 困惑问 并提供连接到OpenRouter的API的MCP服务器实现。它允许您通过OpenRouter与任何兼容MCP的客户端一起使用Perplexity的模型。

特性

  • 全面实施模型上下文协议
  • 通过OpenRouter支持Perplexity的模型:
    • perplexity_ask -使用Sonar模型进行一般查询
    • perplexity_research -使用声纳深度研究模型进行深入研究
    • perplexity_reason -使用声纳推理模型进行复杂的推理任务
  • 服务器发送事件(SSE)支持
  • 流式HTTP传输实现
  • Docker容器化,易于部署

入门指南

环境变量

服务器需要以下环境变量:

  • OPENROUTER_API_KEY -您的OpenRouter API密钥(必需)
  • PORT -运行服务器的端口(默认值:3000)
  • BASE_URL -自定义OpenRouter基本URL(可选)
  • ASK_MODEL -用于提问工具的模型(默认:困惑/声纳专业版)
  • RESEARCH_MODEL -用于研究工具的模型(默认:困惑/声纳深度研究)
  • REASON_MODEL -用于推理工具的模型(默认:困惑/声纳推理pro)
  • DISABLE_ASK -禁用询问工具(默认值:false)
  • DISABLE_RESEARCH -禁用研究工具(默认值:false)
  • DISABLE_REASON -禁用原因工具(默认值:false)

使用Docker运行

运行服务器最简单的方法是使用Docker:

docker run -p 3000:3000 \
  -e OPENROUTER_API_KEY=your_api_key_here \
  ghcr.io/elct9620/perplexity-ask-openrouter:latest

从源头构建

如果您更喜欢从源代码构建:

# Clone the repository
git clone https://github.com/elct9620/perplexity-ask-openrouter.git
cd perplexity-ask-openrouter

# Build Docker image
docker build -t perplexity-ask-openrouter .

API终点

服务器公开以下端点:

  • /sse -用于建立连接的SSE端点
  • /messages -用于向已建立的SSE连接发送消息的端点
  • /mcp -实现MCP协议的流式HTTP端点

与MCP客户端一起使用

此服务器实现了模型上下文协议,因此可以与任何兼容MCP的客户端一起使用。服务器支持SSE和Streamable HTTP传输模式。

Docker部署

该项目包括一个Dockerfile和GitHub Actions工作流,用于构建Docker镜像并将其发布到GitHub容器注册表(ghcr.io)。

许可证

MIT许可证