MCP Client Helper

🚀 MCP-Client-Helpyツールライブラリ

MCPサーバー管理ツールライブラリです。設定ファイルを通じて複数のMCPサーバーインスタンスを管理および制御することができます。

✨ 主な機能

• 設定を通じて複数のMCPサーバーを管理することができます。
• サーバーの起動、停止、再起動をサポートします。
• すべてのサーバーの状態をリアルタイムで監視します。
• イベント駆動型のログとエラー処理を行います。
• カスタム環境変数の設定をサポートします。

📦 インストール

npm install mcp-client-helper

📚 ドキュメント

設定フォーマット

設定オブジェクトのフォーマット例は次の通りです。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your-token-here"
      }
    },
    "other-server": {
      "command": "your-command",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

💻 使用例

基本的な使用法

import { MCPServerManager } from 'mcp-client-helper';
import { readFileSync } from 'fs';

async function main() {
  // 从配置文件加载配置
  const config = JSON.parse(readFileSync('path/to/your/config.json', 'utf-8'));
  
  // 创建服务器管理器实例
  const manager = new MCPServerManager(config);

  try {
    // 获取所有配置的服务器名称
    const serverNames = manager.getServerNames();
    console.log('可用的服务器:', serverNames);

    // 监听特定服务器的事件
    manager.on('log', (serverName, log) => {
      console.log(`[${serverName}] 日志:`, log);
    });

    manager.on('error', (serverName, error) => {
      console.error(`[{serverName}] 错误:`, error);
    });

    manager.on('exit', (serverName, code) => {
      console.log(`[{serverName}] 服务器退出，退出码:`, code);
    });

    // 启动指定的服务器
    await manager.start('github');

    // 获取服务器状态
    const status = manager.getStatus('github');
    console.log('服务器状态:', status);

    // 重启服务器
    await manager.restart('github');

    // 停止服务器
    await manager.stop('github');

    // 动态更新配置
    manager.updateConfig(newConfig);
  } catch (error) {
    console.error('错误:', error);
  }
}

main().catch(console.error);

📚 詳細ドキュメント

APIドキュメント

MCPServerManager

コンストラクタ

constructor(config: MCPConfig)

設定パラメータ：

• config: MCPサーバー設定オブジェクトで、管理するすべてのサーバーの設定が含まれます。

メソッド

• start(serverName: string): Promise<void>：指定されたサーバーを起動します。
• stop(serverName: string): Promise<void>：指定されたサーバーを停止します。
• restart(serverName: string): Promise<void>：指定されたサーバーを再起動します。
• getStatus(serverName: string): ServerStatus | undefined：指定されたサーバーの状態を取得します。
• getServerNames()：すべての設定されたサーバー名を返します。
• updateConfig(newConfig: MCPConfig)：設定を動的に更新します。

イベント

• log：サーバーがログを出力するときにトリガーされ、パラメータは (serverName: string, log: string) です。
• error：サーバーでエラーが発生したときにトリガーされ、パラメータは (serverName: string, error: Error) です。
• exit：サーバーが終了するときにトリガーされ、パラメータは (serverName: string, code: number) です。

開発要件

• Node.jsバージョン：サポートバージョンはパッケージの依存関係を参照してください。
• 追加の依存関係：なし

📄 ライセンス

ISC