Holster

Holster

一个基于 Python 的工具，可直接通过 Claude 桌面应用管理 Claude 配置文件中的 MCP 服务，无需手动修改文本编辑器中的内容。

动机

虽然 Claude 被提示在没有必要时不要使用工具，但它往往过于积极地调用可用工具。不过，谁会想手动添加和移除 MCP 服务呢？

通过文本编辑器管理 MCP 服务非常适合交由大模型完成，但 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 配置文件中的服务配置
• 跟踪已启用和未启用的服务
• 对服务配置执行基本的增删改查操作

范围外

• 自动发现和下载服务
• 基于 Web 的服务搜索
• 工作区管理
• 服务版本管理

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

作者

June Kim 和 LLM 工具