Heimdall

🚀 ハイムダル (Heimdall)

Heimdallは、ローカルのMCPサーバーを管理するための軽量サービスです。単一の npx コマンドで簡単にインストールできます。MCPクライアントに特定のMCPサーバーツールを許可することができ、同じ設定はあなたのデバイス上のすべてのMCPクライアントで利用可能です。

🚀 クイックスタート

Heimdallは、ローカルのMCPサーバーを管理するための軽量サービスです。単一の npx コマンドで簡単にインストールできます。

📦 インストール

⚠️ 重要提示

インストール前にMCPサーバーの設定をバックアップすることを強くおすすめします。これにより、予期せぬデータ損失を防ぐことができます。

インストールスクリプトは以下の重要な操作を実行します:

• 指定されたパスの mcpServers 設定JSONを ~/.heimdall/config.json に移動します。
• 以前の mcpServers 設定パスの位置に heimdall の設定を挿入します。
• すべてのサーバー上のすべてのメソッドを許可するために、制御ファイル ~/.heimdall/controls.json を初期化します。

~/.heimdall/controls.json を変更して、特定のサーバーの許可ツールを制限する方法、および ~/.heimdall/config.json に新しいサーバーを追加する方法については、設定を参照してください。

NPXを使用する（推奨）

1. インストールスクリプトを実行します（パスを指定しない場合は空の設定が生成されます）：

npx @shinzolabs/heimdall setup <オプション: path/to/current/config.json>

ローカルインスタンスを使用する

1. パッケージをダウンロードします：

git clone https://github.com/shinzo-labs/heimdall.git

2. 依存関係をインストールしてビルドします：

cd heimdall && pnpm i && pnpm build

3. インストールスクリプトを実行します（パスを指定しない場合は空の設定が生成されます）：

pnpm run setup <オプション: path/to/current/config.json> <オプション: ローカルのHeimdallインスタンス内の `index.js` ファイルのパス、例 `/path/to/local/heimdall/dist/index.js`>

📚 ドキュメント

設定

サーバーリストの編集

利用可能なサーバーを追加または更新するには、~/.heimdall/config.json にある設定ファイルを直接編集します。形式は通常の mcpServers 設定JSONと同じです。Heimdallで新しいサーバーのツールを表示するには、そのサーバーと許可ツールを ~/.heimdall/controls.json に追加する必要があります。

許可ツールの編集

新しいサーバーまたは既存のサーバーに許可ツールを追加するには、それらを ~/.heimdall/controls.json に追加します。Heimdallは数秒後に内部設定を更新します。MCPクライアントがツールリストの動的キャッシュをサポートしている場合、ツールは自動的に更新されるはずです。そうでない場合は、必要に応じて手動で更新してください。

例

特定のツールを許可するには、~/.heimdall/controls.json に以下の内容を追加します：

{
  "authorized_tools": ["tool1", "tool2"]
}

トラブルシューティング

ツールが表示されない場合

• サーバーとツールが ~/.heimdall/controls.json に正しく追加されていることを確認してください。
• スペルミスや形式の問題がないか確認してください。
• ページを手動で更新するか、サービスを再起動してみてください。

依存関係のインストールに失敗した場合

• 安定したインターネット接続があることを確認してください。
• 管理者権限でコマンドを実行してください。
• package.json と package-lock.json が存在することを確認してください。

🤝 貢献

貢献を歓迎します。何か問題、意見、または懸念事項がある場合は、austin@shinzolabs.com までご連絡ください。