LibreChat MCP Servers

LibreChat MCP 服务

本目录包含 Model Context Protocol (MCP) 服务实现，它们通过 Supergateway 桥接扩展 LibreChat 的能力。

这些是我正在整合在一起的项目。

• 这是为 Agent 提供各种工具的项目。Model Context Protocol Specification
• 将 stdio MCP 服务转换为 SSE，且每个服务都可以在自己的容器中运行。我会观察它的扩展性如何 Supergateway Documentation
• 多 LLM Agent 与 MCP 客户端 LibreChat Documentation

目录结构

mcp/
├── brave-search/          # Brave Search API integration
│   ├── Dockerfile
│   └── README.md
├── [future-server]/      # Template for future MCP servers
│   ├── Dockerfile
│   └── README.md
└── README.md             # This file

添加新的 MCP 服务

1. 在 mcp/ 下为你的服务创建一个新目录
2. 添加必需的文件：
   • Dockerfile - 服务构建配置
   • README.md - 服务专属文档
3. 更新 docker-compose.override.yml 以添加你的服务
4. 更新 librechat.yaml 以配置 MCP 服务

通用配置

每个 MCP 服务应：

1. 使用 Supergateway 作为桥接（stdio 到 SSE）
2. 遵循一致的端口编号（8003+）
3. 连接到 librechat_default 网络
4. 对敏感数据使用环境变量

端口分配

• 8003：Brave Search
• 8004-8099：预留给未来的 MCP 服务

安全最佳实践

1. 绝不提交 API 密钥或敏感数据
2. 对机密信息使用环境变量
3. 遵循最小权限原则
4. 保持服务隔离
5. 定期更新依赖项

使用 Supergateway 将 MCP 服务添加到 LibreChat

本指南提供使用 Supergateway 作为桥接，将任意 MCP 服务添加到 LibreChat 的分步说明。

概述

Supergateway 允许你通过 SSE（Server-Sent Events）运行基于 stdio 的 MCP 服务，这使其非常适合在 Docker 环境中将 MCP 服务与 LibreChat 集成。

前置条件

1. 一个正在运行的 LibreChat 安装
2. Docker 和 Docker Compose
3. 你想要集成的 MCP 服务包

实施步骤

1. 创建服务目录

为你的 MCP 服务创建一个目录：

mkdir mcp-server-name

2. 创建 Dockerfile

创建 mcp-server-name/Dockerfile：

FROM node:18

WORKDIR /app

# Install both supergateway and your MCP server package
RUN npm install -g supergateway @organization/mcp-server-package

# The command runs supergateway as a bridge between your stdio MCP server and SSE
# --stdio: The command to run your MCP server
# --port: The port supergateway will listen on
CMD ["npx", "-y", "supergateway", "--stdio", "npx -y @organization/mcp-server-package", "--port", "8002"]

3. 更新 docker-compose.override.yml

添加你的 MCP 服务：

services:
  mcp-server-name:
    build:
      context: ./mcp-server-name
    ports:
      - "8002:8002"  # Adjust port as needed
    networks:
      - librechat_default
    environment:
      - API_KEY=${YOUR_API_KEY}  # If your server needs API keys
    volumes:
      - ./mcp-server-name:/app  # If your server needs access to local files

4. 更新 librechat.yaml

添加你的 MCP 服务配置：

mcpServers:
  server-name:
    type: sse
    url: "http://mcp-server-name:8002/sse"

理解架构

1. Stdio 到 SSE 桥接：

   • 你的 MCP 服务通过 stdio 通信
   • Supergateway 充当桥接，将 stdio 转换为 SSE
   • LibreChat 连接到 SSE 端点

2. Docker 网络：

   • 所有服务都运行在 librechat_default 网络上
   • 服务可以使用其服务名作为主机名进行通信
   • 仅暴露必要的端口

3. 配置流程：

   • LibreChat 从 librechat.yaml 读取 mcpServers 配置
   • 连接到 Supergateway 的 SSE 端点
   • Supergateway 将请求转发到你的 MCP 服务

常见配置

1. 基础 MCP 服务

mcpServers:
  basic-server:
    type: sse
    url: "http://basic-server:8002/sse"

2. 带 API 密钥的 MCP 服务

# docker-compose.override.yml
services:
  api-server:
    environment:
      - API_KEY=${API_KEY}

# librechat.yaml
mcpServers:
  api-server:
    type: sse
    url: "http://api-server:8002/sse"

3. 带文件访问权限的 MCP 服务

# docker-compose.override.yml
services:
  file-server:
    volumes:
      - ./data:/app/data

# librechat.yaml
mcpServers:
  file-server:
    type: sse
    url: "http://file-server:8002/sse"

故障排查

1. 连接问题：

   • 验证网络配置
   • 检查容器日志：docker compose logs mcp-server-name
   • 确保端口没有冲突

2. 服务未启动：

   • 验证 Dockerfile 中的包安装
   • 检查环境变量
   • 查看服务日志

3. 通信问题：

   • 验证所有配置中的服务名一致
   • 检查容器之间的网络连通性
   • 确保 SSE 端点正确

最佳实践

1. 安全性：

   • 绝不提交 API 密钥或敏感数据
   • 使用环境变量存储机密信息
   • 限制容器权限

2. 网络：

   • 仅暴露必要的端口
   • 尽可能使用 Docker 内部网络
   • 遵循最小权限原则

3. 配置：

   • 保持配置模块化
   • 记录环境变量
   • 使用版本控制管理配置

4. 监控：

   • 记录重要事件
   • 监控资源使用情况
   • 设置健康检查

示例：完整设置

以下是一个添加新 MCP 服务的完整示例：

1. 目录结构：

librechat/
├── mcp-server/
│   └── Dockerfile
├── docker-compose.override.yml
└── librechat.yaml

2. Dockerfile：

FROM node:18
WORKDIR /app
RUN npm install -g supergateway @org/mcp-server
CMD ["npx", "-y", "supergateway", "--stdio", "npx -y @org/mcp-server", "--port", "8002"]

3. docker-compose.override.yml：

services:
  mcp-server:
    build:
      context: ./mcp-server
    ports:
      - "8002:8002"
    networks:
      - librechat_default
    environment:
      - API_KEY=${MCP_API_KEY}

4. librechat.yaml：

mcpServers:
  mcp-server:
    type: sse
    url: "http://mcp-server:8002/sse"

参考资料

• Model Context Protocol 规范
• Supergateway 文档
• LibreChat 文档