STARWARCLOUD STARWAR.AI
返回市场
困惑度-web-mcp-桥接器

困惑度-web-mcp-桥接器

作者：Sukarth6 星标更新：2025-08-02
安装使用来源：spider==github.com

项目介绍

Perplexity Web MCP Bridge

NPM 版本 许可证: MIT GitHub 问题

一个桥接工具，使 Perplexity 的 Web 接口能够使用 MCP（模型上下文协议）工具和服务器，允许无缝集成本地数据源、API 和自定义工具到您的 Perplexity 聊天体验中。

🚀 快速开始

# 安装并运行桥接工具
npx perplexity-web-mcp-bridge

# 或者全局安装
npm install -g perplexity-web-mcp-bridge
perplexity-web-mcp-bridge

然后从 浏览器扩展仓库 安装配套的浏览器扩展。

✨ 功能

  • 无缝集成：直接从 Perplexity 的聊天界面使用 MCP 工具
  • 本地数据访问：连接到本地数据库、文件系统和 API
  • 自定义工具：通过自己的 MCP 服务器扩展 Perplexity 的功能
  • 实时桥接：基于 WebSocket 的通信实现即时响应
  • 简单配置：使用简单的 JSON 配置管理 MCP 服务器
  • 跨平台：适用于 Windows、macOS 和 Linux

🏗 架构

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Perplexity    │    │     Bridge      │    │   MCP Servers   │
│  Web Interface  │◄──►│   (WebSocket)   │◄──►│  (GitHub, etc)  │
│  + Extension    │    │    CLI Tool     │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘

该桥接工具由三个主要组件组成：

  1. CLI 工具（此仓库）：运行一个 WebSocket 服务器，连接到 MCP 服务器
  2. 浏览器扩展：将 MCP 功能注入到 Perplexity 的 Web 接口中
  3. 配置系统：管理 MCP 服务器连接和设置

📦 安装与使用

先决条件

  • Node.js 18+
  • npm 或 yarn
  • Chrome/Chromium 浏览器

CLI 工具安装

选项 1：直接使用 npx 运行（推荐）

npx perplexity-web-mcp-bridge

选项 2：全局安装

npm install -g perplexity-web-mcp-bridge
perplexity-web-mcp-bridge

选项 3：本地开发

git clone https://github.com/sukarth/perplexity-web-mcp-bridge.git
cd perplexity-web-mcp-bridge
npm install
npm start

作为后台服务运行

此 CLI 工具/服务器也可以在 Windows、macOS 和 Linux 上使用 BG-TM 或 PM2 等工具作为后台服务运行，这样终端窗口不需要一直打开以保持服务器运行。

启动服务器

首先，全局安装 BG-TM：

npm install -g @sukarth/bg-tm

然后，启动服务器：

bg-tm run "npx perplexity-web-mcp-bridge"

停止服务器

首先列出所有正在运行的进程以找到正确的进程名称或 ID：

bg-tm list

然后，使用其名称停止服务器：

bg-tm stop <name>

请参阅 BG-TM 文档 获取更多信息。

对于使用 pm2 在后台运行服务器，请参考 pm2 文档。请注意，pm2 不完全支持 Windows 的这种用例。

浏览器扩展安装

浏览器扩展在单独的仓库中可用：perplexity-web-mcp-extension

  1. 从仓库下载并安装扩展
  2. 在 Chrome 中启用它
  3. 扩展会自动连接到桥接工具

⚙ 配置

基本配置

在 ~/.perplexity-mcp/config.json 创建配置文件：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your-github-token-here"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    }
  }
}

可用的 MCP 服务器

可以集成的流行 MCP 服务器：

  • GitHub：@modelcontextprotocol/server-github - 仓库管理
  • 文件系统：@modelcontextprotocol/server-filesystem - 本地文件操作
  • PostgreSQL：@modelcontextprotocol/server-postgres - 数据库查询
  • Brave 搜索：@modelcontextprotocol/server-brave-search - 网络搜索
  • SQLite：@modelcontextprotocol/server-sqlite - SQLite 数据库访问

配置选项

选项描述默认值
portWebSocket 服务器端口54319
config配置文件路径~/.perplexity-mcp/config.json
dev启用详细日志false

示例命令

# 使用默认设置启动桥接工具
npx perplexity-web-mcp-bridge

# 指定自定义端口
npx perplexity-web-mcp-bridge --port 60000

# 使用自定义配置文件
npx perplexity-web-mcp-bridge --config /path/to/config.json

# 启用详细日志（开发模式）
npx perplexity-web-mcp-bridge --dev

# 组合选项
npx perplexity-web-mcp-bridge --port 60000 --config /path/to/config.json --dev

🎯 使用

  1. 启动桥接工具：

    npx perplexity-web-mcp-bridge

  2. 从配套仓库安装浏览器扩展

  3. 在 Chrome 中打开 Perplexity.ai

  4. 直接在对话中使用 MCP 工具：

    • "在我的 GitHub 仓库中搜索 React 项目"
    • "我的 ~/Documents 文件夹中有哪些文件？"
    • "查询我的 PostgreSQL 数据库中的用户统计信息"

🏗 项目结构

perplexity-web-mcp-bridge/
├── bin/
│   └── cli.js              # 主 CLI 入口点
├── src/
│   ├── bridge.js           # WebSocket 服务器及 MCP 管理
│   └── config.js           # 配置处理

├── CHANGELOG.md            # 版本历史
├── CONTRIBUTING.md         # 贡献指南
├── SECURITY.md             # 安全策略

├── package.json
├── README.md
└── LICENSE

🛠 开发

本地开发设置

  1. 克隆仓库：

    git clone https://github.com/sukarth/perplexity-web-mcp-bridge.git
cd perplexity-web-mcp-bridge

  2. 安装依赖项：

    npm install

  3. 在开发模式下运行：

    npm run dev

可用脚本

  • npm start - 启动桥接服务器
  • npm run dev - 启动时启用详细日志
  • npm test - 运行测试（如果可用）

项目架构深入

有关详细的架构信息，请参阅 ARCHITECTURE.md。

🤝 贡献

我们欢迎贡献！请参阅 CONTRIBUTING.md 获取指南。

开发流程

  1. 分叉仓库
  2. 创建功能分支：git checkout -b feature/amazing-feature
  3. 进行更改
  4. 如适用添加测试
  5. 提交更改：git commit -m '添加精彩功能'
  6. 推送到分支：git push origin feature/amazing-feature
  7. 打开拉取请求

🐛 故障排除

常见问题

桥接工具无法启动

  • 检查端口 54319 是否可用
  • 验证 Node.js 版本（需要 1.8+）
  • 检查配置文件语法

MCP 服务器无法连接

  • 验证 MCP 服务器包是否已安装
  • 检查环境变量（API 令牌等）
  • 查看配置文件路径

扩展无法工作

  • 确保桥接工具正在运行
  • 检查浏览器控制台是否有错误
  • 验证扩展是否已启用

调试模式

启用详细日志运行：

npx perplexity-web-mcp-bridge --dev

📝 更改记录

查看 CHANGELOG.md 获取版本历史。

🔒 安全

有关安全问题，请参阅 SECURITY.md。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🔗 相关项目

🙏 致谢

由 Sukarth 制作 ❤️