MCP Server Hub Server

🚀 MCP サーバーガイド

このガイドでは、MCP サーバーのインストール、設定、使用方法、トラブルシューティング、開発とテストについて説明します。

🚀 クイックスタート

📦 インストール

コードのダウンロード

GitHub からリポジトリをクローンします。

git clone https://github.com/your-repository/mcp-server.git
cd mcp-server

依存関係のインストール

npm を使用してプロジェクトの依存関係をインストールします。

npm install

サーバーの起動

メインプログラムファイルを実行してサーバーを起動します。

node src/index.js

⚙️ MCP サーバーの設定

設定ファイル mcp_hub_config.json を編集し、パスが正しいことを確認します。例えば：

{
  "wsPort": 8081,
  "configPath": "path/to/mcp_server_settings.json"
}

💻 使用例

LLM クライアント（Cline など）の使用

LLM クライアントで MCP サーバーを設定します。

クライアントの MCP 設定ファイル（例：cline_mcp_settings.json）を編集します。

{
  "mcpServers": {
    "gateway-client": {
      "command": "node",
      "args": ["path/to/mcp-server/gateway-client.js"],
      "options": {
        "cwd": "path/to/mcp-server"
      }
    }
  }
}

ツールの使用

ツールの一覧表示

LLM クライアントで以下のコマンドを実行します。

llm list-tools

出力例：

{
  "tools": ["hub__example", "thought-server__integrated-thinking"]
}

ツールの呼び出し

ツールの完全修飾名（例：hub__example）を使用して呼び出します。

llm call-tool --tool hub__example --args '{"input": "test"}'

🔧 トラブルシューティング

問題の診断

1. 起動失敗：設定ファイルのパスとコマンドが正しいことを確認します。
2. 接続問題：サーバーが実行中であり、ネットワークファイアウォールが WebSocket ポート（デフォルト ws://localhost:8081）をブロックしていないことを確認します。

ログの確認

MCP サーバーのログを確認します。

# ターミナルで以下のコマンドを実行してリアルタイム出力を確認
npm run dev

👨‍💻 開発とテスト

開発モード

nodemon を使用してファイルの変更を監視します。

npm run dev

テスト

単体テストを実行します。

npm test

詳細については、プロジェクトドキュメントを参照してください。