MCP Server

🚀 MCP Server Dashboard: MCPサーバーの統合管理プラットフォーム

English | 中文版

MCP Server Dashboardは、複数のMCP（Model Context Protocol）サーバーを柔軟なストリーミングHTTP（SSE）エンドポイントにまとめることで、それらの管理とスケーリングを簡素化します。すべてのサーバー、個々のサーバー、または論理的にグループ化されたサーバーコレクションへのオンデマンドアクセスをサポートします。

✨ 主な機能

• 包括的なMCPサーバーサポート：最小限の構成で任意のMCPサーバーをシームレスに統合します。
• 集中管理コンソール：エレガントなWeb UIからすべてのサーバーのリアルタイムステータスとパフォーマンスメトリクスを監視します。
• 柔軟なプロトコル互換性：stdioとSSEの両方のMCPプロトコルを完全にサポートします。
• ホットスワップ可能な構成：ダウンタイムなしで実行時にサーバー構成を動的に追加、削除、または更新します。
• グループベースのアクセス制御：カスタムグループでサーバーを整理し、アクセス許可を管理します。
• 安全な認証システム：JWTとbcryptによるロールベースのアクセス制御を備えた組み込みのユーザー管理。
• Docker対応のデプロイメント：迅速なデプロイメント用のコンテナ化されたイメージが提供されます。

🚀 クイックスタート

設定

mcp_settings.jsonファイルを作成してサーバー設定をカスタマイズします。

{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your-api-key"
      }
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--headless"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "your-bot-token",
        "SLACK_TEAM_ID": "your-team-id"
      }
    }
  }
}

Dockerデプロイメント

Docker Composeでのクイックスタート：

# リポジトリをクローンする
git clone https://github.com/zxerai/MCP-Server.git
cd MCP-Server

# デフォルト設定で起動する
docker-compose up -d

# またはNginxリバースプロキシで起動する
docker-compose --profile nginx up -d

# フルスタックデプロイメント（RedisとPostgreSQLを含む）
docker-compose --profile nginx --profile redis --profile postgres up -d

手動でのDocker実行： カスタム設定をマウントする（推奨）：

docker run -p 3000:3000 -v ./mcp_settings.json:/app/mcp_settings.json -v ./data:/app/data mcpserver:1.0.0

またはデフォルト設定で実行する：

docker run -p 3000:3000 mcpserver:1.0.0

管理コンソールにアクセスする

http://localhost:3000を開き、資格情報でログインします。

⚠️ 重要提示

デフォルトの資格情報はadmin / admin123です。

コンソールの機能：

• すべてのMCPサーバーのステータスをリアルタイムで監視する
• サーバーを有効/無効にする、または再構成する
• サーバーアクセスを整理するためのグループ管理
• アクセス制御のためのユーザー管理

ストリーミングHTTPエンドポイント

⚠️ 重要提示

ストリーミングHTTPエンドポイントのサポートは、異なるAIクライアントによって異なります。問題が発生した場合は、SSEエンドポイントを使用するか、将来のアップデートを待つことができます。

AIクライアント（例：Claude Desktop、Cursor、DeepChatなど）を介して接続します。

http://localhost:3000/mcp

このエンドポイントは、すべてのMCPサーバーに対する統一されたストリーミングHTTPインターフェイスを提供し、以下のことができます。

• 構成された任意のMCPサーバーにリクエストを送信する
• リアルタイムの応答を受信する
• さまざまなAIクライアントやツールと簡単に統合する
• すべてのサーバーに同じエンドポイントを使用し、統合プロセスを簡素化する

スマートルーティング（実験的）： スマートルーティングは、MCP Server Dashboardのインテリジェントなツール検出システムで、ベクトル意味検索を使用して、与えられたタスクに最も関連するツールを自動的に見つけます。

http://localhost:3000/mcp/$smart

動作原理：

1. ツールインデックス作成：すべてのMCPツールが自動的にベクトル埋め込みに変換され、pgvectorを使用してPostgreSQLに保存されます。
2. 意味検索：ユーザークエリがベクトルに変換され、コサイン類似度を使用してツール埋め込みと照合されます。
3. インテリジェントフィルタリング：動的なしきい値により、ノイズのない関連結果が保証されます。
4. 正確な実行：見つかったツールは、適切なパラメーター検証を伴って直接実行できます。

セットアップ要件： スマートルーティングを有効にするには、以下が必要です。

• pgvector拡張機能を備えたPostgreSQL
• OpenAI APIキー（または互換性のある埋め込みサービス）
• MCP Server Dashboard設定でスマートルーティングを有効にする

グループベースのHTTPエンドポイント（推奨）： 特定のサーバーグループへのターゲットアクセスには、グループベースのHTTPエンドポイントを使用します。

http://localhost:3000/mcp/{group}

ここで、{group}はダッシュボードで作成したグループのIDまたは名前です。これにより、以下のことができます。

• ユースケース別に整理された特定のMCPサーバーのサブセットに接続する
• 異なるAIツールを分離して、関連するサーバーのみにアクセスする
• 異なる環境またはチームに対してより細かいアクセス制御を実装する
• グループ名を通じてサーバーを簡単に識別および管理する
• 異なるAIクライアントが同じエンドポイントを使用できるようにし、統合プロセスを簡素化する

サーバー固有のHTTPエンドポイント： 個々のサーバーに直接アクセスするには、サーバー固有の形式を使用します。

http://localhost:3000/mcp/{server}

ここで、{server}は接続したいサーバーの名前です。これにより、特定のMCPサーバーに直接アクセスできます。

⚠️ 重要提示

サーバー名とグループ名が同じ場合、グループ名が優先されます。

SSEエンドポイント（Server-Sent Events）

SSE接続を好むAIクライアントには、これらのエンドポイントを使用します。 グローバルSSEアクセス：

http://localhost:3000/mcp/sse

スマートルーティングSSE：

http://localhost:3000/mcp/sse/$smart

グループベースのSSE：

http://localhost:3000/mcp/sse/{group}

サーバー固有のSSE：

http://localhost:3000/mcp/sse/{server}

💻 ローカル開発

git clone https://github.com/zxerai/MCP-Server.git
cd MCP-Server
pnpm install
pnpm dev

これにより、フロントエンドとバックエンドが開発モードでホットリロードを伴って起動します。

💡 使用建议

Windowsユーザーの場合は、バックエンドサーバーとフロントエンドを個別に起動する必要がある場合があります。pnpm backend:dev、pnpm frontend:dev

🛠️ 一般的な問題とトラブルシューティング

Nginxをリバースプロキシとして使用する

Nginxを使用してMCP Server Dashboardをリバースプロキシする場合は、Nginxの設定に次の構成を追加してください。

proxy_buffering off

完全な構成例については、同梱のnginx.confファイルを参照してください。

Dockerデプロイメントの問題

• ポート競合：ポート3000がすでに使用されている場合は、MCPSERVER_PORT環境変数を変更します。
• パーミッションの問題：Dockerがマウントされたボリュームにアクセスする適切なパーミッションを持っていることを確認します。
• メモリ制限：パフォーマンスの問題が発生した場合は、Dockerのメモリ制限を調整します。

認証の問題

• デフォルトの資格情報：本番環境では、デフォルトの資格情報（admin/admin123）を変更することを忘れないでください。
• JWTトークンの問題：トークン検証の問題が発生した場合は、システム時刻の同期を確認します。

🔧 技術詳細

• バックエンド：Node.js、Express、TypeScript
• フロントエンド：React、Vite、Tailwind CSS
• データベース：SQLite（デフォルト）、PostgreSQL（オプション）
• 認証：JWT & bcrypt
• プロトコル：Model Context Protocol SDK
• コンテナ化：Docker & Docker Compose
• リバースプロキシ：Nginx（オプション）
• キャッシュ：Redis（オプション）

⭐ このリポジトリが役に立った場合は、スターをつけてください！

MCP Server Dashboardチームによって愛情を込めて作成されました。