描述里写清何时用、何时不要用、会改什么。一句「强大的文件工具」没有信息。写成「在允许目录内读取或替换文件；不会跑 shell」。
参数名用领域里的词，并写约束：路径必须落在根目录下、limit 默认 20、dry_run 默认 true。枚举值写全。可空和必填不要靠模型猜。
工具不要太大。一个「做任何 Git 操作」的入口，模型很难选对参数。拆成 status、diff、create_pr，每个只做一件事。对照本站「怎么写一个 MCP 服务器」。
用两三个真实任务试：模型是否选对工具、参数是否一次填对、失败时是否知道换一条。描述改完就复测，不要堆同义词。