★ FEATURED ARTICLE 【免费下载链接】code_puppyAgentic AI for writing code项目地址https://gitcode.com/gh_mirrors/co/code_puppy点击查看免费下载Code Puppy 是一个面向 AI 编程的开源工具内置完整的MCPModel Context Protocol服务器管理体系。你只需用/mcp命令就能完成搜索、安装、启动、停止、日志查看等全部操作连接需要登录的 HTTP MCP 服务器时还能通过OAuth 浏览器授权一键完成认证无需手动配置密钥。本文将带你快速掌握/mcp命令速查表和 OAuth 授权的完整流程。一、MCP 服务器管理为什么每个 AI 编程工具都需要它MCP 是一种让 AI 连接外部工具数据库、文件系统、浏览器等的标准协议。Code Puppy 把 MCP 管理做成了一个内置的「应用商店 控制台」组合应用商店内置 30 预配置服务器目录searchinstall两步即可安装控制台启动、停止、重启、查状态、看日志全部一条命令搞定。核心路由逻辑位于 handler.py所有子命令都注册在这个入口中每个子命令独立成模块便于维护。二、/mcp 命令速查表17 个子命令一次看懂输入/mcp help即可在终端内查看全部帮助帮助文案由 help_command.py 生成。以下是完整的命令速查1. 注册表命令找服务器、装服务器命令作用/mcp search [query]在 30 预配置服务器中按关键词搜索/mcp install id从注册表安装服务器不带参数则打开交互式菜单2. 核心生命周期命令启动与停止命令作用/mcp直接输入即列出所有已注册服务器/mcp start name启动指定服务器/mcp start-all一键启动全部服务器/mcp stop name停止指定服务器/mcp stop-all停止所有运行中的服务器/mcp restart name重启指定服务器3. 管理与排障命令查状态、看日志、改配置命令作用/mcp status [name]查看所有或指定服务器的详细状态/mcp logs name [limit]查看最近事件默认显示 10 条/mcp edit name编辑已有服务器的配置/mcp remove name移除或禁用一个服务器/mcp trust [accept\|revoke\|status]信任当前仓库的.code_puppy/mcp_servers.json/mcp silence-warning永久关闭已注册但未绑定的提示/mcp unsilence-warning恢复该提示4. 一眼看懂状态图标✓ Running ✗ Stopped ⚠ Error ⏸ Quarantined ⭐ Popular✓ Running运行中✗ Stopped已停止⚠ Error出错建议配合/mcp logs排查⏸ Quarantined被隔离连续启动失败后的保护机制⭐ Popular注册表中的热门服务器三、3 步安装一个 MCP 服务器search → install → 绑定 Agent以安装 PostgreSQL 服务器为例/mcp search database # 第 1 步按关键词搜索 /mcp install postgres # 第 2 步按 ID 直接安装 /mcp start postgres # 第 3 步启动并使用几个新手友好的小细节来自 install_command.py 的实现模糊匹配install时既可输入精确 ID也可以输入名称模糊搜索匹配到多个结果时会列出前 5 个供你选择。环境变量提示如果服务器需要环境变量如 API Key安装向导会逐项询问已经设置过的变量会自动标记为已设置并直接沿用。重名保护目标名称已存在时会先征求确认避免误覆盖。安装完成后会弹出Agent 选择菜单按空格键Space切换绑定哪个 Agent 可以使用该服务器A切换自动启动auto-startEnter完成。跳过菜单则服务器处于已安装但未绑定状态之后可以随时用/agents命令中的 MCP 绑定菜单调整。四、OAuth 浏览器授权流程连接需要登录的 HTTP MCP 服务器很多 HTTP 类型的 MCP 服务器如企业内部服务需要账号登录。Code Puppy 支持标准OAuth PKCE流程全程自动发现、自动跳转浏览器你只需在浏览器里点一次允许。完整说明见官方文档 MCP_OAUTH.md底层实现位于 http_auth.py。1. 配置方式只需 4 个字段在/mcp的自定义服务器添加/编辑表单中填入如下 JSON 配置{ type: http, url: https://your-server.example/mcp, auth: oauth, timeout: 330 }2. 授权流程是怎么走的正常启动服务器客户端自动完成OAuth 发现服务端能力探测与PKCE参数生成系统自动打开你的浏览器跳转到登录页在浏览器中完成登录并批准服务器请求的权限本地loopback 回调监听器127.0.0.1接收回调结果校验 state 后自动完成握手连接建立令牌在连接生命周期内自动刷新。3. 新手必知的 4 个注意事项注意点说明⏱ 预留登录时间未显式配置timeout时OAuth 连接默认使用330 秒初始化超时足够从容完成浏览器登录 必须 HTTPS仅本地回环localhost/127.0.0.1允许 HTTP 不要混用auth: oauth不要与Authorization请求头同时使用其他自定义请求头仍受支持 令牌不落盘Token 只保存在内存中不会写入 MCP 配置文件重启 Code Puppy 后可能需要重新登录另外端点必须支持 MCP OAuth 流程及动态客户端注册已有短超时的服务器启用 OAuth 前建议先把timeout调大。五、停止与绑定控制服务器生命周期的进阶技巧解绑 ≠ 停止在 Agent 菜单中解除绑定只会让该 Agent 不再使用服务器并取消它的缓存工具共享的已运行连接不会因此停止要全局停止请用/mcp stop name。显式停止抑制自动重启/mcp stop后在当前会话内该服务器不会再被自动拉起直到你再次执行/mcp start name。停止会打断授权等待stop会取消尚未完成的启动流程包括浏览器授权等待中的状态。enabled: false的作用保存enabled: false会阻止自动启动但显式/mcp start name仍可在本会话强制启用。六、常见问题速查服务器起不来怎么办症状排查命令状态显示 ⚠ Error/mcp logs name查看最近事件启动缓慢/mcp status查看初始化进度仓库自带配置不被加载/mcp trust status查看信任状态用/mcp trust accept授权配置填错了/mcp edit name重新编辑彻底不用了/mcp remove name移除配置文件存储于 mcp_servers_store.py交互式配置向导见 config_wizard.py。写在最后Code Puppy 的/mcp体系把「找服务器 → 装服务器 → 授权 → 绑定 Agent → 排障」串成了一条顺滑的工作流日常操作记住search / install / start / stop / status / logs这 6 个高频命令就够用了遇到需要登录的 HTTP 服务时填上auth: oauth然后放心点浏览器里的允许即可。现在打开 Code Puppy输入/mcp help试试吧赞分享【免费下载链接】code_puppyAgentic AI for writing code项目地址https://gitcode.com/gh_mirrors/co/code_puppy点击查看免费下载相关推荐treg MCP OAuth 授权服务器落地指南一套 OAuth 2.1 授权协议接入 ChatGPT、Claude Code 与所有 MCP 客户端treg MCP OAuth 授权服务器落地指南一套 OAuth 2.1 授权协议接入 ChatGPT、Claude Code 与所有 MCP 客户端 本篇后端API网关MCP 服务dsh-pluginInternVL2-Llama3-76B-AWQ图像Token压缩技巧pixel_shuffle下采样原理与代码逐行解读InternVL2 Llama3 76B AWQ图像Token压缩技巧pixel_shuffle下采样原理与代码逐行解读 InternVL2 Llama3 7Cline MCP OAuth 本地测试服务器完整复现 MCP 授权流程与各类故障模式Cline MCP OAuth 本地测试服务器完整复现 MCP 授权流程与各类故障模式 Cline 在接入需要 OAuth 授权的远程 MCP 服务器时会经人工智能AI 应用AI Agent代码智能体自主智能体工具调用MCP Clients开发工具交互助手浏览器控制上一篇Pollinations Enter 多环境配置矩阵D1、Stripe 与 Tinybird 的服务隔离实践下一篇不重启Python服务如何诊断线上性能瓶颈py-spy实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
