使用说明

项目简介

Claude Auto-Approve MCP 是一个基于 Model Context Protocol (MCP) 实现的服务器,旨在增强 Claude Desktop 应用程序的功能。它通过与 Claude Desktop 的底层机制交互,使其能够根据预设列表自动批准或阻止 AI 进行的工具调用,无需用户手动确认。

主要功能点

  • 工具调用自动化: 允许您配置一个列表,使 Claude Desktop 自动批准或阻止对特定工具的调用。
  • 配置列表查询: 提供 MCP 工具,使 Claude Desktop 可以查询当前配置的自动批准和自动阻止的工具列表。
  • 环境准备: 自动管理 Claude Desktop 运行所需的特定环境(如启用调试端口),以便注入必要的增强功能脚本。

安装步骤

  1. 安装 uv: 确保您的系统上安装了 'uv' 工具。'uv' 用于方便地运行此 MCP 服务器。如果未安装,请参照 uv 官方安装指南 进行安装。
  2. 配置 Claude Desktop: 打开您的 Claude Desktop 配置文件 ('claude_desktop_config.json')。找到或创建 '"mcpServers"' 部分,并将此 MCP 服务器的配置信息添加进去。

服务器配置

在您的 'claude_desktop_config.json' 文件中添加以下配置块:

{
    "mcpServers": {
        "claude-autoapprove-mcp": {
            "command": "uvx",
            "args": [
                "claude-autoapprove-mcp",
                "--port", "19222" // 可选参数:指定Claude Desktop的调试端口,默认为19222。通常保持默认即可。
                // "--persist" // 可选参数 (仅限macOS): 如果希望此功能在系统登录时自动启动并持续监控Claude Desktop,请取消此行注释。仅在macOS上支持。
            ],
            // 可选参数:配置需要自动批准或阻止的工具列表
            "autoapprove": [
                // 在此列出您希望Claude Desktop自动批准调用的工具名称,例如:"get_webpage_content", "read_file"
            ],
            "autoblock": [
                // 在此列出您希望Claude Desktop自动阻止调用的工具名称,例如:"delete_file", "send_email"
            ]
        }
        // 如果您有其他MCP服务器,可以在这里继续添加它们的配置
    }
    // 其他Claude Desktop配置...
}
  • '"claude-autoapprove-mcp"': 您为此 MCP 服务器指定的名称。
  • '"command"': Claude Desktop 用来启动此服务器的命令。'uvx' 是 'uv' 工具的一部分,用于执行安装的包。
  • '"args"': 传递给启动命令的参数。'--port' 用于指定与 Claude Desktop 通信的调试端口;'--persist' (仅macOS) 用于启用持久化监控模式。
  • '"autoapprove"': 一个列表,包含您希望 Claude Desktop 在AI请求调用时自动批准的工具的名称。
  • '"autoblock"': 一个列表,包含您希望 Claude Desktop 在AI请求调用时自动阻止的工具的名称。
  1. 重启 Claude Desktop: 保存 'claude_desktop_config.json' 文件并重新启动 Claude Desktop 应用程序。

基本使用方法

配置并重启 Claude Desktop 后,此 MCP 服务器将自动启动并在后台运行。

  • 工具调用: 当 Claude Desktop 尝试调用工具时,如果该工具的名称出现在您的 'autoapprove' 列表中,调用将被自动批准执行;如果出现在 'autoblock' 列表中,调用将被自动阻止。对于不在列表中的工具,行为将取决于 Claude Desktop 的默认设置(通常是需要用户手动批准)。
  • 查询配置: 您可以在 Claude Desktop 的聊天界面中,通过自然语言 Prompt 来询问此 MCP 服务器当前的自动批准和自动阻止列表,例如:
    list all tools that are auto-approved
    list all tools that are auto-blocked

安全提示

启用此功能需要 Claude Desktop 应用程序开启远程调试端口。虽然此 MCP 服务器默认只监听本地端口,但请注意任何在您计算机上运行的应用程序理论上都可以尝试连接此端口。请确保您了解并接受相关安全风险。

信息

分类

桌面与硬件