困惑Web MCP桥
](https://www.npmjs.com/package/perplexity-web-mcp-bridge)  ](https://github.com/sukarth/perplexity-web-mcp-bridge/issues)
一个桥梁,使Perplecity的web界面能够使用MCP(模型上下文协议)工具和服务器,允许将本地数据源、API和自定义工具无缝集成到您的Perplecity聊天体验中。
🚀 快速开始
# Install and run the bridge
npx perplexity-web-mcp-bridge
# Or install globally
npm install -g perplexity-web-mcp-bridge
perplexity-web-mcp-bridge然后从安装配套浏览器扩展 浏览器扩展库.
✨ 特性
- 无缝集成:直接从Perplexity的聊天界面使用MCP工具
- 本地数据访问:连接到本地数据库、文件系统和API
- 自定义工具:使用您自己的MCP服务器扩展Perplexity的功能
- 实时桥梁:基于WebSocket的即时响应通信
- 易于配置:用于MCP服务器管理的简单JSON配置
- 交叉平台的:适用于Windows、macOS和Linux
🏗️ 建筑
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Perplexity │ │ Bridge │ │ MCP Servers │
│ Web Interface │◄──►│ (WebSocket) │◄──►│ (GitHub, etc) │
│ + Extension │ │ CLI Tool │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘这座桥由三个主要部分组成:
- CLI工具 (此存储库):运行连接到MCP服务器的WebSocket服务器
- 浏览器扩展:将MCP功能注入到Perplexity的web界面中
- 配置系统:管理MCP服务器连接和设置
📦 安装与使用
先决条件
- Node.js 18+
- npm或纱线
- 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工具/服务器还可以使用BG-TM或PM2等其他工具在Windows、macOS和Linux上作为后台服务运行,这样服务器就不需要保持终端窗口打开才能继续运行。
启动服务器
首先,安装BG-TM(全局):
npm install -g @sukarth/bg-tm然后,启动服务器:
bg-tm run "npx perplexity-web-mcp-bridge"正在停止服务器
首先列出所有正在运行的进程,以找到正确的进程名称或ID:
bg-tm list然后,使用其名称停止服务器:
bg-tm stop 请检查 BG-TM文件 了解更多信息。
要使用pm2在后台运行服务器,请参阅 pm2文件请注意,对于此用例,Windows不支持pm2。
浏览器扩展安装
浏览器扩展程序在单独的存储库中可用: 困惑网络mcp扩展
- 从存储库下载并安装扩展
- 在Chrome中启用它
- 分机将自动连接到网桥
⚙️ 配置
基本配置
在以下位置创建配置文件 ~/.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-数据库查询 - 勇敢的搜索:
@modelcontextprotocol/server-brave-search-网络搜索 - 数据库:
@modelcontextprotocol/server-sqlite-SQLite数据库访问
配置选项
| 选项 | 描述 | 默认值 |
|---|---|---|
port | WebSocket服务器端口 | 54319 |
config | 配置文件路径 | ~/.perplexity-mcp/config.json |
dev | 启用详细日志记录 | false |
示例命令
# Start the bridge with default settings
npx perplexity-web-mcp-bridge
# Specify a custom port
npx perplexity-web-mcp-bridge --port 60000
# Use a custom config file
npx perplexity-web-mcp-bridge --config /path/to/config.json
# Enable verbose logging (dev mode)
npx perplexity-web-mcp-bridge --dev
# Combine options
npx perplexity-web-mcp-bridge --port 60000 --config /path/to/config.json --dev🎯 用法
- 启动桥梁:
npx perplexity-web-mcp-bridge- 安装浏览器扩展 来自配套存储库
- 打开困惑.ai 在Chrome浏览器中
- 使用MCP工具 直接在您的对话中:
- “在我的GitHub仓库中搜索React项目” - “我的~/Documents文件夹中有哪些文件?” - “查询我的PostgreSQL数据库以获取用户统计信息”
🏗️ 项目结构
perplexity-web-mcp-bridge/
├── bin/
│ └── cli.js # Main CLI entry point
├── src/
│ ├── bridge.js # WebSocket server & MCP management
│ └── config.js # Configuration handling
├── CHANGELOG.md # Version history
├── CONTRIBUTING.md # Contribution guidelines
├── SECURITY.md # Security policy
├── package.json
├── README.md
└── LICENSE🛠️ 发展
地方发展设置
- 克隆存储库:
git clone https://github.com/sukarth/perplexity-web-mcp-bridge.git
cd perplexity-web-mcp-bridge- 安装依赖项:
npm install- 在开发模式下运行:
npm run dev可用脚本
npm start-启动网桥服务器npm run dev-从详细日志记录开始npm test-运行测试(如果可用)
项目架构深度学习
有关详细的体系结构信息,请参见 建筑.md.
🤝 贡献
我们欢迎捐款!请看 贡献.md 作为指导方针。
开发过程
- 分叉存储库
- 创建要素分支:
git checkout -b feature/amazing-feature - 进行更改
- 如果适用,添加测试
- 提交您的更改:
git commit -m 'Add amazing feature' - 推到分支:
git push origin feature/amazing-feature - 打开拉取请求
🐛 故障排除
常见问题
大桥无法启动
- 检查端口54319是否可用
- 验证Node.js版本(需要18+)
- 检查配置文件语法
MCP服务器未连接
- 验证MCP服务器软件包是否已安装
- 检查环境变量(API令牌等)
- 查看配置文件路径
扩展不起作用
- 确保桥梁正在运行
- 检查浏览器控制台是否有错误
- 验证是否启用了扩展
调试模式
运行详细日志记录:
npx perplexity-web-mcp-bridge --dev📝 更新日志
看 更改日志.md 版本历史。
🔒 安全
有关安全问题,请参阅 安全.md.
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🔗 相关项目
- 困惑Web MCP扩展 -配套浏览器扩展
- MCP服务器集合 -官方MCP服务器实施
🙏 致谢
- 模型上下文协议(MCP) 对于精彩的协议
- 困惑AI 令人惊叹的人工智能模型和搜索界面
- MCP服务器实现的开源社区
______________________________________________________________________
由以下材料制成❤️ 靠近 苏卡斯
