AI Agent代码智能体人工智能大模型CLI【免费下载链接】kimi-codeKimi Code CLI — The Starting Point for Next-Gen Agents项目地址https://gitcode.com/gh_mirrors/ki/kimi-code点击查看免费下载导读mcp-config是 Kimi Code 内置技能built-in skill当用户通过/mcp-config或/skill:mcp-config触发它时Kimi Code 会直接在本轮对话内完成两件小而本地的任务一是处理 MCP 服务器请求的 OAuth 登录二是编辑维护mcp.json中的 MCP 服务器清单。读完本文你将掌握 MCP 配置三文件的优先级与取舍、stdio/http 条目的最小可运行写法、全局超时参数的正确用法以及如何安全地处理令牌等敏感信息——并能通过仓库源码确认每一项配置的真实约束。技能触发与流程分流在 mcp-config.ts 中可以看到该技能以mcp-config.md的原始文本为唯一内容来源import MCP_CONFIG_BODY from ./mcp-config.md?raw通过parseSkillText解析为SkillDefinition并带有disableModelInvocation: true标记——这意味着它只能被用户显式调用如/mcp-config login server而不会被模型自行隐式唤起。技能一旦被触发需要根据用户的话 当前工具列表二选一分流Login 流程若当前工具列表中存在mcp__server__authenticate工具且用户提到 log in / auth / sign in、执行/mcp-config login server或引用了needs-auth状态则进入登录流程。Config edit 流程用户要新增 / 编辑 / 删除 / 列出mcp.json条目或者裸调/mcp-config且工具列表中没有authenticate 工具此时若有待处理的登录authenticate 工具必然会在列表中所以可直接判定为配置编辑。LoginOAuth 登录的委托与边界每个处于needs-auth状态的 MCP 服务器都会暴露一个mcp__server__authenticate工具。登录流程的核心原则是全权委托、原文转达直接调用用户所指服务器的 authenticate 工具——该工具自身的 description 就负责完整的 OAuth 体验打印授权 URL、阻塞等待回调、成功后自动重连将工具的输出逐字呈现尤其是授权 URL 不得做任何改写。URL 中携带的 state 与 PKCE 参数一旦被编辑就会失效若用户点名了某个没有authenticate 工具的服务器只用一句话说明并停止绝不转入 config edit——他们想登录的服务器当前并未等待登录擅自改写mcp.json是错误修复若存在多个 authenticate 工具而用户未指明服务器用提问确认用户指的是哪一个。Config edit三文件优先级与目录解析三个配置文件配置按以下优先级存放键冲突时后出现的文件覆盖先出现的文件作用域路径适用场景用户全局KIMI_CODE_HOME/mcp.json想在所有项目生效的服务器项目根project root/.mcp.jsonClaude 兼容、仓库共享、跨 Agent 的服务器项目本地cwd/.kimi-code/mcp.json仅当前工作目录的 Kimi 专属覆盖其中项目根通过从cwd向上逐级寻找最近的.git目录确定。必须先解析 KIMI_CODE_HOMEKimi Code 运行时解析用户全局数据目录的规则是优先取KIMI_CODE_HOME环境变量为空时才回退到~/.kimi-code。这与 bootstrap.ts 中homeDir ?? env[KIMI_CODE_HOME] ?? join(osHomeDir, .kimi-code)的解析逻辑一致。因此动手读写用户全局文件前必须先用 Bash 解析出真实的目录绝不能想当然地假定为~/.kimi-codeecho $KIMI_CODE_HOME echo $HOME/.kimi-code第一行非空则取第一行否则取第二行。下文KIMI_CODE_HOME均指这个已解析的数据根目录。安全提示需向用户说明一次项目根.mcp.json与项目本地.kimi-code/mcp.json中的 stdio 条目会在会话启动时执行命令因此这类文件只应存在于可信仓库中。配置条目的结构与字段约束三个文件对条目的包装方式完全相同{ mcpServers: { name: { /* entry */ } } }最小 stdio 条目{ mcpServers: { my-server: { command: npx, args: [-y, modelcontextprotocol/server-...] } } }必备command可选args、env、cwd。项目根.mcp.json中的 stdio 条目默认从项目根运行相对cwd会以包含.mcp.json的目录为基准解析。最小 http 条目{ mcpServers: { remote: { url: https://mcp.example.com/sse } } }必备url。使用静态 bearer 令牌的服务器用bearerTokenEnvVar: ENV_NAME引用环境变量走 OAuth 的服务器不需要任何令牌字段由上文 Login 流程处理。transport 推断与完整字段transport字段由command还是url自动推断不要手写。这一点在 schema.ts 的McpServerConfigSchema预处理中可见传入对象缺transport时若含command则补transport: stdio若含url则补transport: http再交给z.discriminatedUnion(transport, ...)校验。较少用到的字段enabled、startupTimeoutMs、toolTimeoutMs、enabledTools、disabledTools、headers以McpServerStdioConfigSchema/McpServerHttpConfigSchema为唯一事实来源两者定义在 schema.tsstdio schematransport: stdio、command非空字符串、可选args、env、cwd、executorlocal/kaoshttp schematransport: http、url合法 URL、可选headers、auth: oauth、bearerTokenEnvVar公共字段enabled、startupTimeoutMs、toolTimeoutMs、enabledTools、disabledTools见 schema.ts 的McpServerCommonFields另有McpServerSseConfigSchema支持transport: sse的远程服务器配置。全局超时配置别往每个条目里写当用户想调整所有服务器的超时时不要在每个条目里分别写startupTimeoutMs/toolTimeoutMs——全局默认值在config.toml的[mcp]段startup_timeout_ms/tool_timeout_ms或由环境变量KIMI_MCP_STARTUP_TIMEOUT_MS/KIMI_MCP_TOOL_TIMEOUT_MS提供每个服务器的字段会覆盖全局默认值。这一机制的实现证据在 configSection.tsMcpSectionSchema只含startupTimeoutMs与toolTimeoutMs两个可选字段并通过mcpEnvBindings将两者分别绑定到KIMI_MCP_STARTUP_TIMEOUT_MS与KIMI_MCP_TOOL_TIMEOUT_MS环境变量parseTimeoutMsEnv在解析环境变量时同样执行范围校验非法值直接丢弃。无论来自哪个层级任何超时都必须是1到2147483647毫秒之间的整数——这正是 schema.ts 中MAX_MCP_TIMEOUT_MS 2_147_483_647与McpTimeoutMsSchema z.number().int().min(1).max(MAX_MCP_TIMEOUT_MS)的约束。查看模式只读合并视图如果用户只是想看看配了哪些服务器流程是读取全部三个文件展示合并视图并附上足够的来源路径上下文让用户能定位到真正声明该服务器的文件去检查或移除——然后停止不弹 scope 提问不做任何写入。编辑流程三步走确定 scope能从用户措辞推断就推断——global / everywhere / all projects → 用户全局root / repo / shared / cross-agent / Claude /.mcp.json→ 项目根cwd / current directory / Kimi-specific /.kimi-code→ 项目本地。请求确实无 scope 时用一次AskUserQuestion在用户全局 / 项目根 / 项目本地之间询问默认倾向用户全局其余所有问题用纯文本提问AskUserQuestion不适合自由输入。若用户关闭了 scope 问题就停止——无法安全猜测改动位置。读取并公示读取目标文件缺失或为空都合法将创建{ mcpServers: {} }。若 JSON 解析失败原样展示错误并停止——静默覆盖损坏的文件可能摧毁数据。随后向用户展示目标路径、文件当前内容、以及即将写入或删除的条目。这是为了透明而非确认关卡——真正的关卡是编辑/写入权限弹窗你的消息为弹窗出现时提供上下文在 yolo / auto 模式下没有权限弹窗这正是该模式显式约定的行为。写入并告知重载方式保留无关条目与mcpServers包装层。MCP 服务器在会话启动时加载因此必须告知用户开启新会话如/new或重启kimi-code后改动才会生效。Secrets令牌不要写进配置文件mcp.json是磁盘上的明文配置文件严禁把令牌、密钥、密码以字面量形式写入http 服务器应使用bearerTokenEnvVar引用环境变量若 stdio 条目确需在env中内联一个秘密值写入前必须先警告用户。总结mcp-config技能把 Kimi Code 的 MCP 配置体验收敛为两个清晰路径有 authenticate 工具就走 OAuth 登录全权委托、URL 原样转达否则走三文件配置编辑先解析KIMI_CODE_HOME、按优先级定位 scope、透明读写、会话重启后生效。配合 schema.ts 与 configSection.ts 的源码约束你可以精确预判每种写法的校验结果避免踩中 transport 推断、超时范围与明文密钥等常见陷阱。赞分享AI Agent代码智能体人工智能大模型CLI【免费下载链接】kimi-codeKimi Code CLI — The Starting Point for Next-Gen Agents项目地址https://gitcode.com/gh_mirrors/ki/kimi-code点击查看免费下载相关推荐Proxmark3 FM11RF08S 恢复脚本现已支持 Windows 与 AndroidProxmark3 FM11RF08S 恢复脚本现已支持 Windows 与 Android Proxmark3 项目对 FM11RF08S 恢复脚本做了更新渗透测试嵌入式物联网网络安全Obsidian REST API 交互服务器——MCP-obsidian 安装与配置指南Obsidian REST API 交互服务器——MCP obsidian 安装与配置指南 1. 项目基础介绍 MCP obsidian 是一个开源项目旨在通从 Claude Code / Codex 迁移到 Kimi Code内置技能 import-from-cc-codex 的指令、技能与 MCP 配置导入指南从 Claude Code / Codex 迁移到 Kimi Code内置技能 import from cc codex 的指令、技能与 MCP 配置导入指南AI Agent代码智能体人工智能大模型CLI上一篇Sakurairo: 一个多彩且强大的WordPress主题搭建指南下一篇【亲测免费】 椒盐音乐 Salt Player 开源项目使用教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考