用途：为 AI 智能体提供本地编码原语，通过 MCP 协议接入 Claude Code、Cursor 等客户端，让智能体在受限工作区内读文件、搜索、打补丁、跑命令和查 Git 历史。
主要能力：文件操作（read_file、list_dir、list_files、search_text，自动排除 .git、node_modules、dist、venv、pycache 等构建产物）；结构化补丁（apply_patch，支持 dry_run 预览）；命令执行（exec_command，含超时、输出上限、环境变量过滤、破坏性命令检查，安全模式下拦截 shell 展开与网络命令）；交互式会话（write_stdin、kill_session 管理 stdin）；只读 Git（git_status、git_diff、git_log、git_show、git_blame）；工作区管理（get_default_cwd、set_default_cwd、server_info）；view_image（需 [image] 附加依赖支持自动缩放）；request_permissions 申请受限权限。
使用方式：可用 uvx coding-tools-mcp --workspace /path/to/repo 直接运行，或 curl -fsSL https://raw.githubusercontent.com/xyTom/coding-tools-mcp/main/scripts/install.sh | bash 安装；源码方式为 git clone https://github.com/xyTom/coding-tools-mcp.git 后 python -m pip install -e ".[dev]"，图片支持加 ".[image]"。客户端配置示例：命令 uvx，参数 ["coding-tools-mcp", "--stdio", "--workspace", "/path/to/repo"]。HTTP 模式暴露于 http://127.0.0.1:8765/mcp。
权限与限制：三种模式，safe（默认，拦截 shell 展开与网络命令）、trusted（本地开发，允许依赖下载与内联解释器片段）、dangerous（仅限隔离容器/VM，关闭 exec_command 权限门）。可用 CODING_TOOLS_MCP_TOOL_PROFILE=read-only 暴露只读工具集；compat-readonly-all 仅标记只读，并非安全模式。所有路径须在工作区内，拒绝绝对路径、.. 穿越和符号链接逃逸。它不是完整沙箱，Landlock 仅在 Linux 内核 5.13+ 生效，未受信任代码应使用 Docker 或 VM。远程访问建议 bearer 或 OAuth 2.1，noauth 仅供测试。当前资料未提供定价与具体平台支持范围。