Librechatmcpservers

🚀 自由聊天 MCP サーバー

自由聊天 MCP サーバーは、柔軟に新しい MCP サーバーを追加できるシステムです。以下に、そのディレクトリ構造や追加手順などを詳しく説明します。

📚 ディレクトリ構造

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

📦 新しい MCP サーバーの追加手順

ステップ 1：新しいディレクトリの作成

librechat/mcp-server/ ディレクトリの下に新しいサブディレクトリを作成します。例えば、brave-search を作成します。

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

ステップ 2：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"]

ステップ 3：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 内でパスワードやその他の機密情報をハードコードしないでください。

メンテナンスに関する提案

• 定期的に依存ライブラリを更新してセキュリティを保ちます。
• コンテナの実行状態を監視し、異常があればすぐに対処します。

参考資料

• モデルコンテキストプロトコル仕様
• スーパーゲートウェイドキュメント
• 自由チャットドキュメント

### ステップ 4：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}

ステップ 5：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 サーバーを簡単に追加することができます。