Librechatmcpservers

LibreChat通过Supergateway桥接集成MCP服务器，扩展多工具代理能力，支持容器化部署和SSE通信协议。

人工智能聊天机器人开发者工具 #多工具代理 #容器化 #SSE通信 #协议扩展

评分 : 2.5分

下载量 : 26

更新时间 : 2025-04-28

什么是MCP服务器？

MCP服务器是一种标准化工具，用于在LibreChat中引入外部AI模型或插件，从而增强对话管理和多语言支持能力。它允许开发者轻松创建自定义插件并与LibreChat无缝集成。

如何使用MCP服务器？

只需几步即可设置并运行MCP服务器，包括安装依赖、配置环境变量以及启动服务。完成后，您可以通过LibreChat调用这些插件。

适用场景

适用于需要扩展LibreChat功能的企业客户、开发者社区和个人用户。例如，企业可以添加特定行业知识库，而个人用户则能接入更多有趣的插件。

主要功能

插件支持支持第三方插件的快速集成，无需复杂编码即可实现功能扩展。

多语言处理内置多语言处理能力，支持跨语言对话和翻译。

标准化接口遵循Model Context Protocol (MCP)标准，确保兼容性和一致性。

优势与局限性

优势

简单易用：快速上手，无需深入了解底层技术。

灵活性高：支持多种插件和工具集成。

安全性强：采用加密通信协议保护数据传输安全。

局限性

性能依赖：插件性能可能影响整体系统响应速度。

开发成本：对于复杂插件，仍需一定开发投入。

如何使用

安装MCP服务器

克隆项目仓库并构建容器镜像。

配置环境变量

设置必要的API密钥和其他敏感信息。

启动服务

运行容器并将服务暴露给LibreChat。

使用案例

搜索产品信息利用搜索引擎插件查询特定商品的价格和评价。

生成代码片段调用代码生成插件编写Python脚本。

常见问题

如何添加新的MCP服务器？

是否支持自定义插件？

如何确保数据安全？

🚀 自由聊天 MCP 服务器

自由聊天 MCP 服务器项目提供了一种便捷的方式来添加和管理新的 MCP 服务器。通过一系列明确的步骤，用户能够轻松地将新的服务器集成到项目中，同时还提供了完整的示例和注意事项，帮助用户顺利完成操作。

🚀 快速开始

目录结构

librechat/
├── mcp-server/
│   ├── brave-search/
│   │   └── Dockerfile
│   └── future-reserved/
│       └── Dockerfile
└── documentation/
    └── adding-mcp-servers.md

添加新 MCP 服务器的步骤

第一步：创建新目录

在 librechat/mcp-server/ 目录下创建一个新的子目录，例如 brave-search。

mkdir -p librechat/mcp-server/brave-search

第二步：添加 Dockerfile

在 brave-search 目录下创建一个 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"]

第三步：添加 README.md 文件

在 brave-search 目录下创建一个 README.md 文件，并添加以下内容：

# 勇敢搜索 MCP 服务器

## 安装说明

### 克隆仓库
```bash
git clone https://github.com/yourusername/librechat.git
cd librechat/mcp-server/brave-search

构建镜像

docker build -t brave-search .

运行容器

docker run --name brave-search-container -p 8002:8002 brave-search

配置说明

修改 docker-compose 文件

在 librechat/ 目录下找到或创建 docker-compose.override.yml 文件，添加以下内容：

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

修改 LibreChat 配置文件

在 librechat/ 目录下找到或创建 librechat.yaml 文件，添加以下内容：

mcpServers:
  brave-search:
    type: sse
    url: "http://brave-search:8002/sse"

故障排除

容器无法启动

检查 Docker 是否正确安装并运行。
确保 Dockerfile 内容无误。

服务间通信问题

确保所有容器都在同一个网络中。
检查服务名称是否一致。

最佳实践

安全建议

使用环境变量存储敏感信息（如 API 密钥）。
避免在 Dockerfile 中硬编码密码或其他敏感信息。

维护建议

定期更新依赖库以保证安全。
监控容器运行状态，及时处理异常情况。

参考资料


#### 第四步：更新 docker-compose 文件
在 `librechat/` 目录下找到或创建 `docker-compose.override.yml` 文件，添加以下内容：
```yaml
services:
  brave-search:
    build:
      context: ./mcp-server/brave-search
    ports:
      - "8002:8002"
    networks:
      - librechat_default
    environment:
      - API_KEY=${MCP_API_KEY}

第五步：更新 LibreChat 配置文件

在 librechat/ 目录下找到或创建 librechat.yaml 文件，添加以下内容：

mcpServers:
  brave-search:
    type: sse
    url: "http://brave-search:8002/sse"

💻 使用示例

完整示例

目录结构

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

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"]

docker-compose.override.yml 示例

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

librechat.yaml 示例

mcpServers:
  brave-search:
    type: sse
    url: "http://brave-search:8002/sse"

命令行示例

# 构建所有镜像
docker-compose -f docker-compose.override.yml build

# 启动所有服务
docker-compose -f docker-compose.override.yml up -d

# 查看运行中的容器
docker ps | grep librechat