Librechatmcpservers

🚀 自由聊天 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

📚 詳細文檔

注意事項

• 確保 Docker 和 docker-compose 已正確安裝。
• 檢查網絡配置，確保所有服務在同一個網絡中。
• 定期備份重要數據以防止丟失。

通過以上步驟，您可以輕鬆添加新的 MCP 服務器到您的項目中。