Holster

Holster

Claude デスクトップから Claude の設定ファイル内の MCP サーバーを直接管理する Python ベースのツールです。テキストエディターで手動編集する必要がなくなります。

動機

必要のないときにツールを使わないよう Claude に指示しても、Claude は利用可能なツールを呼び出すことに積極的になりすぎることがよくあります。しかし、MCP サーバーを手動で追加したり削除したりするのは誰がやるのでしょうか？

テキストエディターで MCP サーバーを管理する作業は LLM に適していますが、現在 Claude が提供するのは設定ファイルへのポインターだけです。Holster は、Claude デスクトップ内からサーバーをシームレスに管理できるインターフェースを提供し、この体験の向上を目指しています。

機能

• 🔄 Claude デスクトップ内でシームレスにサーバーを管理
• 📝 適切な解析とエンコードによる JSON 設定の処理
• 📋 アクティブなサーバーと非アクティブなサーバーを個別に追跡
• 🛠️ シンプルなコマンドラインインターフェース
• ✅ 包括的なテストカバレッジ

インストール

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

git clone https://github.com/yourusername/holster.git
cd holster

2. 仮想環境を作成して有効化します。

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. uv を使って依存関係をインストールします。

uv pip install -r requirements.txt

設定

デフォルトの設定ファイルの場所は次のとおりです。

~/Library/Application Support/Claude/claude_desktop_config.json

増え続ける MCP サーバーのリストに、これを追加します。

    "holster": {
        "command": "uv",
        "args": [
            "--directory",
            "<THIS_DIRECTORY>",
            "run",
            "holster.py"
        ]
    }

設定を再読み込みするため、Claude を再起動します。

使用方法

Holster の概要

まず、Holster の仕組みについて詳しく確認できます。

# Get detailed explanation of Holster's functionality
explanation = await explain_holster()
print(explanation["overview"])
print(explanation["tools"])

新しいサーバーの作成

# Create a new server configuration
server_config = await create_server(
    name="my_server",
    command="uv",
    directory="/path/to/server",
    script="server.py"
)

サーバーのステータスの確認

# Get lists of active and inactive servers
servers = await list_servers()
print("Active servers:", list(servers["active"].keys()))
print("Inactive servers:", list(servers["inactive"].keys()))

サーバーのステータスの更新

# Deactivate servers
result = await update_server_status(
    server_names=["server1", "server2"],
    active=False
)
print(f"Deactivated {len(result['updated'])} servers")

# Activate servers
result = await update_server_status(
    server_names=["server1", "server2"],
    active=True
)
print(f"Activated {len(result['updated'])} servers")

サーバーの削除

# Delete servers from both active and inactive lists
result = await delete_servers(["server1", "server2"])
print(f"Deleted {len(result['deleted'])} servers")
print(f"Remaining active: {result['remaining_active']}")
print(f"Remaining inactive: {result['remaining_inactive']}")

ヘルスチェック

# Check if Holster server is running
response = await ping()
print(response)  # Should print "Pong!"

開発

テストの実行

python -m pytest test_holster.py -v

対象範囲

対象範囲内

• Claude の設定ファイル内でのサーバー設定の管理
• アクティブなサーバーと非アクティブなサーバーの追跡
• サーバー設定に対する基本的な CRUD 操作

対象範囲外

• サーバーの自動検出とダウンロード
• Web ベースのサーバー検索
• ワークスペースの管理
• サーバーのバージョン管理

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細については、LICENSE ファイルをご覧ください。

作成者

June Kim & LLM ツール