工具参考

按类别列出 MCP 工具、输入行为和边界。

​

工具参考

本页列出 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

这些是 Git 查看工具，不会 commit、checkout、reset、push 或修改仓库状态。

​

权限工具

工具	用途	关键输入
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 或外层包装禁用该能力。输入文件必须位于工作区路径边界内。