Codex Hookify MCP

Codex挂钩MCP服务器

mcp starter

Created by

此存储库包含一个MCP服务器，它带来了Claude Code的功能 hookify 安全插件 codex 生态系统。此服务器允许您定义规则，在AI代理执行危险操作之前对其进行警告或阻止。

它是基于 MCP服务器启动器.

特性

• 全面的事件拦截：根据一组用户定义的规则拦截和评估事件。支持的活动包括：

- bash：Shell命令 - file：文件创建和编辑 - prompt：用户提示提交 - stop：代理停止事件

• 克劳德 hookify 兼容性：解析并使用Claude Code的规则文件 hookify 插件(.claude/hookify.*.local.md)以及当地 ~/.codex/hookify 目录。
• 可配置操作：规则可以配置为 warn 执行前的用户或 block 命令完全。
• 灵活的规则定义：规则用YAML frontmatter在简单的Markdown文件中定义，便于创建和修改。
• 完整的MCP工具：展示一套清晰的MCP工具 codex 评估事件并管理规则。
• 📡 灵活的沟通：支持多种通信协议(stdio, http).
• 📦 最小设置：快速开始基本的服务器实现。
• 🤖 Codex CLI集成：包括示例 config.toml 配置用于 codex.
• ⌨️ TypeScript：为您的项目添加类型安全。

入门指南

先决条件

• MCP兼容客户端（例如。， 法典)

安装

1. 克隆存储库：

   git clone https://github.com/instructa/codex-hookify-mcp.git
   cd codex-hookify-mcp

1. 安装依赖项：

   pnpm install

1. 构建服务器：

   pnpm build

这将编译TypeScript源代码为 ./dist.

用法

此服务器设计用于 codex 通过其MCP服务器集成。

标准

这是当地推荐的交通方式 codex 使用。

将以下内容添加到您的 ~/.codex/config.toml 文件来注册Hookify服务器。确保使用 绝对路径 到已编译的服务器入口点(dist/server.js).

[mcp_servers.hookify]
command = "node"
args = ["/home/projects/temp/codex-hookify-mcp/dist/index.mjs"]
startup_timeout_sec = 60

codex 现在，当Hookify MCP服务器启动时，它将自动启动。

规则目录

默认情况下，服务器从以下位置加载规则 ~/.codex/hookify。您可以通过设置 HOOKIFY_RULE_DIR 环境变量。

规则是 .md 使用YAML frontmatter的文件。请参阅 hookify-plugin/hookify/examples 目录示例。

MCP工具

服务器公开以下工具供使用 codex:

评估

• hookify_evaluate_shell：计算shell命令。

- 输入: { "command": "shell command to evaluate" }

• hookify_evaluate_file：评估文件编辑。

- 输入: { "file_path": string, "old_text"?: string, "new_text"?: string, "content"?: string }

• hookify_evaluate_prompt：评估用户提示。

- 输入: { "user_prompt": string }

• hookify_evaluate_stop：评估停止事件。

- 输入: { "transcript": string }

• 输出（适用于所有评估工具）：一个JSON字符串 { "decision": "allow" | "warn" | "block", "messages": string[], "matched_rules": string[] }

规则管理

• hookify_list_rules：列出当前加载的所有规则。
• hookify_create_rule：从结构化参数创建新的规则文件。
• hookify_set_rule_enabled：启用或禁用特定规则。

- 输入: { "name": "rule-name", "enabled": true | false }

• hookify_delete_rule：删除特定规则。

- 输入: { "name": "rule-name" }

健康与帮助

• hookify_health：返回服务器的状态和配置信息。
• hookify_help：返回hookify插件的markdown帮助字符串。

______________________________________________________________________

通用MCP启动器信息

以下部分包含来自MCP Server Starter模板的原始信息。

支持的传输选项

模型上下文协议支持多种传输方法。

标准

mcp starter

建议用于本地设置

代码编辑器支持

添加下面的代码片段

• 光标： .cursor/mcp.json

本地开发/测试

如果您想在本地测试您的mcp服务器，请使用此选项

{
  "mcpServers": {
    "codex-hookify-mcp-stdio": {
      "command": "node",
      "args": ["./dist/index.mjs", "--stdio"]
    }
  }
}

可流式传输的HTTP

mcp starter

重要提示：Cursor尚不支持流式HTTP

建议使用远程服务器

重要提示： 与stdio相反，您还需要使用正确的标志运行服务器

地方发展 使用 streamable http 运输

1. 启动MCP服务器

在你的终端上运行这个

node ./dist/index.mjs --http --port 4200

或与mcp检查员联系

npm run dev-http

1. 将此添加到您的配置中

{
  "mcpServers": {
    "codex-hookify-mcp-http": {
      "command": "node",
      "args": ["./dist/index.mjs", "--http", "--port", "4001"]
    }
  }
}

使用检查器

使用 inspect 调试mcp服务器的命令

mcp starter mcp starter

命令行选项

协议选择

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

______________________________________________________________________

课程

• 学习用AI构建软件： 教程.ai