工具参考
本页列出coding_tools_mcp.server 当前实现的工具。实际可见工具由 --tool-profile 决定。
Profiles
| Profile | 暴露工具 |
|---|---|
full | 暴露全部实现工具。 |
read-only | 只暴露检查类工具，隐藏补丁、命令、cwd 修改和权限请求等工具。 |
compat-readonly-all | 兼容模式：把暴露工具注解为只读，但部分工具仍可能改变本地状态。 |
服务和工作区工具
| 工具 | 用途 | 关键输入 |
|---|---|---|
server_info | 返回服务元数据、协议信息、当前 profile 和能力信息。 | 无 |
check_exec_environment | 报告命令执行环境和隔离状态。 | 无 |
get_default_cwd | 返回运行时默认工作目录。 | 无 |
set_default_cwd | 修改后续相对命令操作使用的默认工作目录。 | path |
set_default_cwd 不会在 read-only profile 中暴露。
文件和搜索工具
| 工具 | 用途 | 关键输入 |
|---|---|---|
read_file | 从工作区文件读取 UTF-8 文本。 | path、start_line、end_line、max_bytes、encoding |
list_dir | 列出目录项，可递归。 | path、recursive、max_depth、max_entries、include_hidden、include_ignored、sort |
list_files | 按 glob 风格模式查找文件。 | path、patterns、glob、exclude_patterns、include_hidden、include_ignored、max_results、sort |
search_text | 用字面量或正则搜索文本。 | query、path、regex、case_sensitive、include_globs、exclude_globs、context_lines、max_results |
read_file只支持utf-8，会拒绝看起来像二进制的文件。read_file.max_bytes上限为 1 MiB。search_text优先使用rg，不可用时回退到 Python 扫描。- 默认忽略
.git、node_modules、构建产物、虚拟环境和常见缓存目录。
编辑工具
| 工具 | 用途 | 关键输入 |
|---|---|---|
apply_patch | 在工作区内应用 unified patch。 | patch、dry_run |
apply_patch 在 read-only 中隐藏。可以先用 dry_run 验证补丁。
命令工具
| 工具 | 用途 | 关键输入 |
|---|---|---|
exec_command | 在工作区中启动或运行命令。 | cmd、workdir、timeout_ms、yield_time_ms、max_output_bytes、stdin、tty、env |
write_stdin | 向运行中的命令 session 写入输入或轮询输出。 | session_id、chars、yield_time_ms、max_output_bytes |
kill_session | 终止运行中的命令 session。 | session_id、signal、wait_ms、max_output_bytes |
safe 会阻止网络特征命令、shell 展开、内联脚本、敏感环境和宽泛临时目录写入。trusted 允许常见本地开发流程，同时保留敏感环境过滤和可用时的 Landlock。dangerous 会关闭命令权限门禁。
Git 工具
| 工具 | 用途 | 关键输入 |
|---|---|---|
git_status | 返回仓库状态。 | path、include_untracked、max_entries |
git_diff | 返回 staged 或 unstaged diff。 | path、paths、staged、unstaged、context_lines、max_bytes |
git_log | 返回最近提交。 | path、ref、max_count、skip |
git_show | 查看某个 revision，可包含 diff。 | rev、path、paths、include_diff、context_lines、max_bytes |
git_blame | 返回指定行范围的 blame 信息。 | path、rev、start_line、end_line、max_lines |
权限工具
| 工具 | 用途 | 关键输入 |
|---|---|---|
request_permissions | 为受限操作请求权限。 | tool_name、permission、reason、arguments、scope、ttl_seconds |
tool_name 可取 exec_command 和 apply_patch。权限名包括 network、destructive_command、long_timeout、sensitive_env、shell_expansion、inline_script、privileged_executable 和 write_generated_or_ignored。
图片工具
| 工具 | 用途 | 关键输入 |
|---|---|---|
view_image | 读取本地图片，并返回 MCP image payload 或 data URL。 | path、max_bytes、max_width、max_height、auto_resize、output |
view_image 默认启用，除非设置 CODING_TOOLS_MCP_ENABLE_VIEW_IMAGE=0 或外层包装禁用该能力。输入文件必须位于工作区路径边界内。