资讯动态

GitHub MCP Server 多语言配置指南:如何让工具描述说中文

发布时间:2026/9/2 10:21:50 来源:尧图企业网站定制
GitHub MCP Server 多语言配置指南如何让工具描述说中文【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server你八成见过这种场面AI 助手列出 MCPModel Context Protocol模型上下文协议工具清单每条描述都是英文。GitHub MCP Server 国际化这事其实不用改代码三层配置就能让工具说明换成中文。AI 助手列出的工具说明全是英文怎么变中文先说结论每个工具的描述在代码里都对应一个翻译键你只需要给这个键配一个值。GitHub MCP Server 内置了 i18ninternationalization即国际化机制。工具描述不是写死的而是键 默认值的形式。键没配值时显示英文默认值配了值就显示你的值。整个过程不碰源码、不重新编译。配完重启服务中文描述立刻出现在工具列表里。一条文案的旅程它是怎么被找到的一条描述会经过三站先到的赢而不是代码里写的那句赢。打个比方代码默认值像餐厅的印刷菜单做进程序里JSON 配置文件像摆在桌上的替换菜单页环境变量像钉在菜单上的手写便签。代码读取顺序把便签放在第一站所以它优先级最高——这正是 翻译核心模块 里TranslationHelper的工作方式。三站都只走一次。查到的结果会存进内存同一条描述后面再被请求直接返回缓存。五分钟上手一条环境变量加一份 JSON最短路径就两步配一条export然后重启。想改get_commit工具的说明用工具键 前缀export GITHUB_MCP_TOOL_GET_COMMITS_DESCRIPTION获取GitHub仓库中某个提交的详细信息 export GITHUB_MCP_TOOL_GET_COMMITS_USER_TITLE查看提交详情键名规律TOOL_ 工具名全大写 _DESCRIPTION或_USER_TITLE。改完重启AI 助手看到的描述就是中文了。想一次改多处就在二进制同目录放一个github-mcp-server-config.json{ TOOL_GET_COMMITS_DESCRIPTION: 获取GitHub仓库中某个提交的详细信息, TOOL_GET_COMMITS_USER_TITLE: 查看提交详情, SERVER_TITLE: 我的 GitHub MCP Server }文件名和位置不能错必须叫github-mcp-server-config.json且和可执行文件在同一目录。同样改完重启即生效。批量翻译与部署从 1 个键到 100 个键翻译一两个键是手动活翻译一整套工具说明需要一个小机关--export-translations。在本地跑./github-mcp-server --export-translations程序会把当前所有翻译键导出成github-mcp-server-config.json。你已有的修改会保留程序新加的键也会补进来。等于自动生成了一份待翻译模板填完中文就能用。这是 GitHub MCP Server 国际化里最实用的一步。Docker 部署时容器里的工作目录是/server二进制也在那儿。把配置挂载进去即可docker run -v $(pwd)/github-mcp-server-config.json:/server/github-mcp-server-config.json ...。两种方式怎么选看这张表场景推荐姿势原因只改 1~2 条描述环境变量不用建文件CI 里一目了然翻译整套工具说明JSON 文件挂载可批量编辑、可 diff、可进版本库临时调试某条文案环境变量用完 unset不污染文件避坑清单现象 → 原因 → 一句话修复九成翻译不生效的 case问题都不在翻译本身而在配置姿势。对照检查一下现象重启后描述还是英文→ 原因环境变量少了GITHUB_MCP_前缀翻译键等于白写 → 把变量名改成GITHUB_MCP_ 全大写键名。现象JSON 配了不生效→ 原因文件没放在二进制所在目录 → 把github-mcp-server-config.json挪到可执行文件旁边。现象键明明在配置里值却没被用上→ 原因键名大小写对不上 → 全部键名写全大写与--export-translations的输出口径一致。现象改了文件但描述没变→ 原因服务没重启翻译在启动时读取并缓存 → 重启进程。现象不知道有哪些键可翻→ 原因键散落在工具定义里手工翻找成本高 → 跑一次--export-translations导出的 JSON 就是完整清单。更多细节可以翻一下 README.md 里的 i18n 章节。可以直接偷走的设计思路这个小项目的 i18n 设计有三点可以搬进你自己的项目。三层优先级。环境变量 配置文件 代码默认值每层都能覆盖下一层。定制不改码是云原生工具的标准姿势。只查一次之后全走缓存。每个键解析完就写进内存 map重复请求零成本。查找逻辑和缓存放在同一个闭包里代码非常短。键名即文档。TOOL_GET_COMMITS_USER_TITLE一眼看出是哪个工具、哪个字段再配上--export-translations键清单随代码自动更新不用人肉维护文档。【免费下载链接】github-mcp-serverGitHubs official MCP Server项目地址: https://gitcode.com/GitHub_Trending/gi/github-mcp-server创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价