项目简介

Claude Code Helper (CCH) 不仅是一个命令行工具，还是一个功能强大的MCP服务器，专为Claude Code环境设计。它允许LLM客户端以标准化的方式访问和管理您的Claude Code工作区，包括配置管理、权限控制、缓存优化、安全审计和系统诊断等功能。通过JSON-RPC协议，CCH MCP服务器能够响应LLM客户端的请求，提供上下文信息并执行特定操作。

主要功能点

MCP工具托管与执行: 提供诊断 ('doctor')、日志查看 ('view-logs')、MCP配置重载 ('reload-mcp')、MCP工具发现 ('discover-mcp-tools')、权限批量管理 ('add-permission', 'remove-permission')、工具批量管理 ('add-tool', 'remove-tool')、配置备份与恢复 ('backup', 'restore') 等多个工具，LLM可直接调用执行。
上下文管理: 允许LLM获取Claude Code项目的当前状态、配置信息和历史数据。
交互模式: 支持可定制的LLM交互模式，通过标准化的工具调用提供丰富功能。
安全性: 具备安全检测和防护机制，例如危险命令检测和敏感信息（secrets）掩码处理。
日志与诊断: 提供详细的日志查看和系统健康诊断工具，帮助LLM和开发者理解系统状态。
性能优化: 提供缓存分析与清理功能，帮助LLM优化Claude Code的性能和存储。

安装步骤

确保Claude CLI已安装: CCH MCP服务器需要Claude CLI来与其环境进行交互。请访问Claude Code官网安装桌面应用，并确保 'claude' 命令在您的系统PATH中可用。

安装CCH作为全局CLI工具:

npm install -g @light-merlin-dark/claude-code-helper

安装MCP服务器: 运行以下命令将CCH注册为Claude Code的MCP服务器。这会配置Claude Code以通过 'cch-mcp' 命令启动CCH MCP服务器。
```
cch install
```
重启Claude Code: 安装完成后，请重启您的Claude Code应用程序，以便Claude CLI加载新的MCP服务器配置。

服务器配置 (供MCP客户端连接的参考信息)

MCP客户端通过JSON-RPC协议连接到MCP服务器。在Claude Code环境中，CCH MCP服务器通常通过 'stdio' 传输协议启动，其核心配置如下：

服务器名称 (serverName): 'cch' （MCP服务器的唯一标识符）
命令 (command): 'cch-mcp' （启动MCP服务器的实际命令）
环境变量 (env):
- 'NODE_NO_WARNINGS': '"1"' （用于抑制Node.js警告）
描述 (description): '"Claude Code Helper MCP Server for configuration, permissions, and diagnostics."'

基本使用方法

一旦CCH MCP服务器安装并Claude Code重启，您可以直接通过LLM客户端（如Claude自身）来调用其提供的工具：

运行诊断:
- "Use CCH to run diagnostics on my setup."
- "Run CCH doctor."
查看日志:
- "Show me the recent error logs using CCH."
- "Use CCH view-logs to search for 'failed' messages."
重载MCP配置:
- "Reload the 'aia' MCP configuration using CCH."
- "Use CCH to reload all MCPs."
发现MCP工具:
- "Use CCH to discover frequently used MCP tools."
- "Find MCP tools I often use in my projects."
管理权限:
- "Use CCH to add 'docker:*' permission to all my projects."
- "Remove dangerous permissions from my projects using CCH."
备份配置:
- "Create a backup of my Claude Code configuration using CCH."

关键词

信息