MCP Manager Local

MCP Manager Local

ローカルで動作するシンプルな Web マネージャーです。MCP（Multi-Capability Protocol）サーバーの起動、停止、設定、ログの表示に加え、Git リポジトリから新しいサーバーをクローンし、JSON で設定を追加できます。

機能

• Web インターフェース： http://localhost:3000 からアクセスできる Web インターフェースで MCP サーバーを管理します。
• サーバー管理：
  • サーバー設定を手動で追加します。
  • JSON オブジェクトを貼り付けて設定を追加します。
  • 既存の設定（名前、コマンド、引数、環境変数）を編集します。
  • 設定をリストから削除します。
• プロセス制御：
  • MCP サーバーのプロセスを個別に起動（「オン」）および停止（「オフ」）します。
  • ステータス（実行中、停止、エラーなど）を表示します。
• ログの表示： インターフェースでサーバーの標準出力（stdout）と標準エラー出力（stderr）をリアルタイムで確認できます。
• Git クローン： MCP サーバーを含む Git リポジトリをインターフェースから直接クローンします。クローンしたサーバーのプレースホルダーが、後で設定できるようリストに自動追加されます。
• 永続化： サーバー設定はローカルの servers.json ファイルに保存されます。

前提条件

• Node.js： バージョン 18 以上を推奨します。(Node.js をダウンロード)
• Git： クローン機能に必要です。(Git をダウンロード)

インストールと実行（開発）

1. リポジトリをクローンします：

   git clone https://github.com/silastorres14/mcp-manager.git
   

2. フォルダーに移動します：

   cd <nome-do-repositorio>
   

3. 依存関係をインストールします：

   npm install
   

4. （任意）初期サーバーを設定します：

   • servers.json ファイルを手動で編集して、初期設定を追加できます。
   • 重要： シークレット（API キー、クライアントシークレット）を含む servers.json ファイルを公開リポジトリにコミットしないでください。リポジトリをクローンした後、シークレットを含む設定は Web インターフェースから追加してください。リポジトリ内の servers.json には、サンプルのみを含めるか、空の状態にしてください。

5. MCP Manager サーバーを起動します：

   node server.js
   

6. インターフェースにアクセスします：

   • Web ブラウザーを開き、http://localhost:3000 にアクセスします。

実行ファイルのビルド（任意）

pkg を使って単体で動作する実行ファイルを作成できます。

1. ビルドスクリプトを実行します（package.json で定義されています）：

   npm run build-pkg
   

   (これにより、コマンド pkg . --targets ... --output ... が実行されます)

2. 実行ファイルを確認します： 実行ファイル（例：Windows の場合は mcp-manager.exe）は dist/ フォルダー内に作成されます。

3. 実行します：

   • 重要： servers.json ファイル（初期設定を含むもの、または空のもの）を、実行ファイルと同じ階層にある dist/ フォルダー内へコピーします。
   • 実行ファイルをダブルクリックするか、ターミナルから実行します：.\mcp-manager.exe または ./mcp-manager。
   • ブラウザーで http://localhost:3000 にアクセスします。
   • 実行ファイルを使って最初のリポジトリをクローンすると、cloned_servers/ フォルダーが dist/ 内に作成されます。

使用方法

1. アクセス： ブラウザーで http://localhost:3000 を開きます。
2. サーバーをクローン： 「MCP リポジトリをクローン」セクションを使用して、Git リポジトリからサーバーをダウンロードします。プレースホルダーがリストに追加されます。
3. JSON で追加： 「JSON で設定を追加」セクションを使用して、完全な設定を貼り付けて追加します。
4. 手動で追加： 「サーバーを手動で追加」をクリックし、フォームに詳細を入力します。
5. サーバーを管理：
   • リスト内のサーバーをクリックすると、ログを確認できます（実行中の場合）。
   • アクションボタン（▶、■、✎、🗑️）を使用して、サーバーの起動、停止、編集、削除を行います（編集／削除の操作は、サーバーが停止している場合のみ有効です）。
   • 編集するときは、サーバーを起動できるように、コマンド、引数（カンマ区切り）、環境変数（JSON 形式）の各フィールドに正しく入力してください。必要に応じて、引数には絶対パスを使用します。

servers.json の構造

servers.json ファイルにはオブジェクトの配列が格納され、各オブジェクトが設定済みの MCP サーバーを表します。

[
  {
    "id": "uuid-gerado-automaticamente",
    "name": "Nome Amigável do Servidor",
    "description": "Descrição opcional.",
    "command": "comando_para_executar", // ex: "node", "python", "/caminho/executavel"
    "args": ["argumento1", "/caminho/script.js", "--flag"], // Array de strings
    "env": { // Objeto chave-valor para variáveis de ambiente
      "VARIAVEL_1": "valor1",
      "API_KEY": "NAO_COMITAR_SEGREDOS_AQUI"
    }
  }
]