跳到正文
FunCoding

搜索

搜索文档、智能体、博客、Skill 和 MCP

MCP 与 Hooks

在 Droid 里用注册表或命令行添加 MCP 服务器,用 hooks.json 在生命周期事件运行确定性的 shell 命令。

MCP

MCP 服务器为 Droid 扩展工具和上下文,有两种管理方式:TUI 里的交互式管理器(/mcp),或 droid mcp 命令行。想用 Factory 托管设置和引导式认证的受支持云应用,用 Connectors;自定义工具、自托管服务或需要直接控制时用 MCP。快速上手:在 Droid 里输入 /mcp,选「Add from Registry」,从注册表(如 linear、sentry、notion、figma、stripe、supabase、vercel、playwright 等)选一个;需要 OAuth 的远程服务器按浏览器提示完成。/mcp 管理器还能浏览服务器及其连接状态、查看工具、启用/禁用而不删除、通过浏览器认证、清除认证、移除用户配置的服务器。

Hooks

Hooks 是在 Droid 会话的特定节点运行的 shell 命令,用于每次都应发生的确定性行为:校验工具调用、格式化改动的文件、注入本地上下文、记录活动、执行团队策略。Hooks 以你本地的环境和凭证自动运行,注册前务必审查每条命令、用绝对脚本路径、先在安全环境测试。配置位置:用户 ~/.factory/hooks.json(跨项目);项目 .factory/hooks.json(提交共享);企业(组织托管设置);旧版 .factory/hooks/hooks.json 仍会加载,下次保存时迁移。没有 hooks.json 时也读对应 settings.json 里的 hooks 键。hook 命令要用绝对路径,因为它们在 Droid 当前工作目录运行,可能不是仓库根;项目脚本用 "$FACTORY_PROJECT_DIR"/path/to/script.sh。结构按事件名分组,每个事件含若干匹配器组,组内含一条或多条 shell 命令:

{
  "PreToolUse": [
    {
      "matcher": "Execute",
      "commandRegex": "^git ",
      "hooks": [{ "type": "command", "command": "/usr/local/bin/audit-git-command.sh", "timeout": 30 }]
    }
  ]
}

可用事件、输入输出契约见官方 Hooks 页;hooksDisabled 设置可整体关闭 hooks,/hooks 管理。