Perplexity MCP Docker

困惑MCP服务器

基于人工智能的Web搜索与研究的多架构Docker镜像

______________________________________________________________________

📋 目录

• 概述
• 支持的体系结构
• 可用标签
• 快速开始
• 配置
• MCP客户端配置
• 网络配置
• 更新
• 故障排除
• 附加资源
• 支持和许可
• 重大变化

______________________________________________________________________

😎 给我买杯咖啡☕︎

您的支持鼓励我继续创建/支持我的开源项目。 如果你在这个项目中发现了价值，你可以给我买杯咖啡，让我保持灵感。

概述

困惑MCP服务器通过模型上下文协议提供基于人工智能的网络搜索和研究功能。基于Alpine Linux构建，占用空间最小，安全性最高。

主要特点

✨ 多架构支持 -原生支持x86-64和ARM64\ 🚀 多种传输协议 -HTTP、SSE和WebSocket支持\ 🔒 设计安全 -基于阿尔卑斯山，攻击面最小\ ⚡ 高性能 -ZSTD压缩可实现更快的部署\ 🎯 生产就绪 -经过全面测试的稳定版本\ 🔧 易于配置 -简单的环境变量设置

______________________________________________________________________

支持的体系结构

💡 多拱形图像会自动为您的系统选择正确的架构。

______________________________________________________________________

可用标签

系统要求

• Docker引擎： 23.0+
• 猛撞： 最小512MB
• CPU： 单芯足够

🔒 关键： 在没有适当的安全措施（反向代理、SSL/TLS、身份验证、防火墙规则）的情况下，不要将此容器直接暴露在互联网上。

______________________________________________________________________

快速开始

Docker Compose（推荐）

services:
  perplexity-mcp:
    image: mekayelanik/perplexity-mcp:stable
    container_name: perplexity-mcp
    restart: unless-stopped
    ports:
      - "8050:8050"
    environment:
      - PORT=8050
      - INTERNAL_PORT=38011
      - PUID=1000
      - PGID=1000
      - TZ=Asia/Dhaka
      - NODE_ENV=production
      - PROTOCOL=HTTP
      - ENABLE_HTTPS=false
      - HTTP_VERSION_MODE=auto
      # Optional: require Bearer token auth at HAProxy layer
      # - API_KEY=replace-with-strong-secret
    hostname: perplexity-mcp
    domainname: local

部署：

docker compose up -d
docker compose logs -f perplexity-mcp

Docker命令行界面

docker run -d \
  --name=perplexity-mcp \
  --restart=unless-stopped \
  -p 8050:8050 \
  -e PORT=8050 \
  -e INTERNAL_PORT=38011 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Asia/Dhaka \
  -e NODE_ENV=production \
  -e PROTOCOL=HTTP \
  -e ENABLE_HTTPS=false \
  -e HTTP_VERSION_MODE=auto \
  mekayelanik/perplexity-mcp:stable

访问端点

启用HTTPS时(ENABLE_HTTPS=true)，使用TLS端点：

⚠️ 安全警告： 容器现在默认为HTTP(ENABLE_HTTPS=false)以便于本地设置。使用 ENABLE_HTTPS=true 用于生产、公共网络或任何不受信任的环境。 ⏱️ ARM设备： 在访问端点之前，请允许30-60秒进行初始化。

______________________________________________________________________

配置

环境变量

HTTPS和HTTP版本说明

• 如果 ENABLE_HTTPS=true 如果缺少证书文件，容器会自动生成自签名证书。
• 如果 TLS_CERT_PATH 和 TLS_KEY_PATH 存在，它们被合并到 TLS_PEM_PATH 并直接使用。
• HTTP_VERSION_MODE=h3 （或 auto)仅当HAProxy构建包含QUIC时才启用HTTP/3；否则，它会安全地回落。

API密钥验证说明

• 集 API_KEY 以在反向代理级别强制执行身份验证。
• 预期的标题格式： Authorization: Bearer .
• 本地主机健康检查仍然可以访问活动/准备状态。

用户和组ID

找到您的ID并设置它们以避免权限问题：

id username
# uid=1000(user) gid=1000(group)

时区示例

- TZ=Asia/Dhaka        # Bangladesh
- TZ=America/New_York  # US Eastern
- TZ=Europe/London     # UK
- TZ=UTC               # Universal Time

______________________________________________________________________

MCP客户端配置

运输支持

⚠️ \*WebSocket是实验性的(第1288期)

______________________________________________________________________

VS代码（Cline/Roo-Cline）

在中配置 .vscode/settings.json:

{
  "mcp.servers": {
    "perplexity": {
      "url": "http://host-ip:8050/mcp",
      "transport": "http"
    }
  }
}

______________________________________________________________________

克劳德桌面应用程序/克劳德代码

配置：

带API_KEY

claude mcp add-json github '{"type":"http","url":"http://localhost:8045/mcp","headers":{"Authorization":"Bearer "}}'

不带API_KEY

claude mcp add-json github '{"type":"http","url":"http://localhost:8045/mcp"}'

______________________________________________________________________

Codex CLI

在中配置 ~/.codex/config.json:

{
  "mcpServers": {
    "perplexity": {
      "transport": "http",
      "url": "http://host-ip:8050/mcp"
    }
  }
}

______________________________________________________________________

Codeium（风帆）

在中配置 .codeium/mcp_settings.json:

{
  "mcpServers": {
    "perplexity": {
      "transport": "http",
      "url": "http://host-ip:8050/mcp"
    }
  }
}

______________________________________________________________________

光标

在中配置 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "perplexity": {
      "transport": "http",
      "url": "http://host-ip:8050/mcp"
    }
  }
}

______________________________________________________________________

测试配置

验证 MCP检查员:

npm install -g @modelcontextprotocol/inspector
mcp-inspector http://host-ip:8050/mcp

______________________________________________________________________

网络配置

比较

______________________________________________________________________

网桥网络（默认）

services:
  perplexity-mcp:
    image: mekayelanik/perplexity-mcp:stable
    ports:
      - "8050:8050"

优点： 容器隔离，易于设置，适用于任何地方 访问权限： http://localhost:8050/mcp

______________________________________________________________________

主机网络（仅限Linux）

services:
  perplexity-mcp:
    image: mekayelanik/perplexity-mcp:stable
    network_mode: host

优点： 最高性能，无NAT开销，无需端口映射 注意事项： 仅限Linux，共享主机网络命名空间 访问权限： http://localhost:8050/mcp

______________________________________________________________________

MACVLAN网络（高级）

services:
  perplexity-mcp:
    image: mekayelanik/perplexity-mcp:stable
    mac_address: "AB:BC:CD:DE:EF:01"
    networks:
      macvlan-net:
        ipv4_address: 192.168.1.100

networks:
  macvlan-net:
    driver: macvlan
    driver_opts:
      parent: eth0
    ipam:
      config:
        - subnet: 192.168.1.0/24
          gateway: 192.168.1.1

优点： 专用IP，直接局域网接入 注意事项： 仅限Linux，需要额外设置 访问权限： http://192.168.1.100:8050/mcp

______________________________________________________________________

更新

Docker Compose

docker compose pull
docker compose up -d
docker image prune -f

Docker命令行界面

docker pull mekayelanik/perplexity-mcp:stable
docker stop perplexity-mcp && docker rm perplexity-mcp
# Run your original docker run command
docker image prune -f

Watchtower的一次性更新

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once \
  perplexity-mcp

______________________________________________________________________

故障排除

飞行前检查表

• ✅ Docker引擎23.0+
• ✅ 端口8050可用
• ✅ 充足的启动时间（ARM设备）
• ✅ 最新稳定图像
• ✅ 配置正确

常见问题

容器无法启动

# Check Docker version
docker --version

# Verify port availability
sudo netstat -tulpn | grep 8050

# Check logs
docker logs perplexity-mcp

权限错误

# Get your IDs
id $USER

# Update configuration with correct PUID/PGID
# Fix volume permissions if needed
sudo chown -R 1000:1000 /path/to/volume

客户端无法连接

# Test connectivity
curl http://localhost:8050/mcp
curl http://host-ip:8050/mcp
curl -k https://localhost:8050/mcp
curl -k https://host-ip:8050/mcp

# Check firewall
sudo ufw status

# Verify container
docker inspect perplexity-mcp | grep IPAddress

ARM性能缓慢

• 启动后等待30-60秒
• 监视器： docker logs -f perplexity-mcp
• 检查资源： docker stats perplexity-mcp
• 使用更快的存储（SSD与SD卡）

调试信息

报告问题时，包括：

# System info
docker --version && uname -a

# Container logs
docker logs perplexity-mcp --tail 200 > logs.txt

# Container config
docker inspect perplexity-mcp > inspect.json

______________________________________________________________________

附加资源

文档

• 📚 困惑官方文件
• 📦
• 🔧 MCP检查员

Docker资源

• 🐳
• 🌐
• 🛡️

监控

• 📊 Diun-更新通知器
• ⚡ 瞭望塔

______________________________________________________________________

😎 给我买杯咖啡☕︎

您的支持鼓励我继续创建/支持我的开源项目。 如果你在这个项目中发现了价值，你可以给我买杯咖啡，让我保持灵感。

支持和许可

获取帮助

Docker镜像问题：

• github：

困惑MCP问题：

• github： 应用人工智能/模型上下文协议/问题
• 网站： docs.perplexity.ai

贡献

我们欢迎捐款：

1. 通过GitHub Issues报告错误
2. 建议功能
3. 改进文档
4. 测试版发布

许可证

GPL许可证。看 许可证 了解详情。

困惑MCP服务器有自己的许可证-请参阅 .

______________________________________________________________________

重大变化

Initial Release: Full CI/CD pipeline with HAProxy, HTTPS/TLS, QUIC/HTTP3, API key auth

⬆ 返回页首