Genify

genify

面向 AI 编码 Agent 的 MCP 工具，可在项目根目录内安全地规划、比较差异并应用结构化文件更改。

使用 genify 可重复执行代码库编辑：写入文件、替换文本、在标记周围插入区块、移动/复制/删除路径、创建目录、更改模式，以及在应用更改前生成试运行差异。

将单个文件转变为完整项目

核心思路是使用单个源文件，配合不同的配置文件，快速、一致地生成或更新完整的项目结构。

共有三种模式：

• CLI 交互模式——用于手动操作和快速输入。
• 代码模式——用于自动化、可配置的项目生成。
• MCP 服务模式——供通过 STDIO 调用结构化工具的 AI 编码 Agent 使用。

功能：

• 根据配置从模板创建文件。
• 使用正则表达式替换内容。
• 向现有文件追加或前置内容。
• 使用共享配置轻松更新多个项目。

安装

Cargo

• 按照本指南安装 Rust 工具链，以便安装 cargo。
• 运行

  cargo install genify --features cli
  

快速开始

CLI

Turn one file into a complete project

Usage: genify [OPTIONS] [PATH]
       genify <COMMAND>

Arguments:
  [PATH]  Path to a config file or http(s) URL

Options:
  -p, --props-json <JSON>  Override props using a JSON object (Array/Map supported)
  -n, --no-interaction     Do not ask any interactive question
  -h, --help               Print help
  -V, --version            Print version

Commands:
  mcp   Start genify as an MCP server over STDIO
  help  Print this message or the help of the given subcommand(s)

example.toml

[props]
value = "value"
dir = "tmp"
val = "val"
other = "{{ val }}"
override = "1"

[[rules]]
type = "write"
path = "{{ dir }}/some.txt"  # if the file exists will be error
content = "{{ val }} {{ value }} {{ other | pascal_case }} {{ override }} - should be replaced"
if_exists = "error"

[[rules]]
type = "replace"
path = "{{ dir }}/some.txt"
replace = "should.*replaced"
content = "replaced {{ value }}"

[[rules]]
type = "prepend"
path = "{{ dir }}/some.txt"
content = "prepend {{ value }}"

[[rules]]
type = "append"
path = "{{ dir }}/some.txt"
content = "append {{ value }}"

genify example.toml

使用 JSON 从 CLI 覆盖属性（包括 Array/Map）：

genify example.toml --props-json '{"tags": ["cli", "json"], "meta": {"license": "MIT"}}'

tmp/some.txt

prepend value
val value Val 1 - replaced value
append value

MCP

使用标准 STDIO 传输方式，将 genify 作为 MCP 服务运行：

genify mcp --root .

用于只读 Agent 会话：

genify mcp --root . --read-only

Codex 配置示例：

[mcp_servers.genify]
command = "genify"
args = ["mcp", "--root", "."]

MCP 服务仅向 stdout 写入协议消息；日志和诊断信息写入 stderr。 所有文件系统访问均限制在 --root 范围内。

可用工具：

工具	行为
genify_plan	返回计划执行的文件操作和受影响的路径，不写入文件。
genify_diff	以试运行模式执行生成操作，并返回统一差异。
genify_apply	仅当 explicit_approval 为 true 或 confirm_token 为 "apply" 时应用更改。
genify_validate_config	验证配置解析、渲染和生成的路径。
genify_list_templates	列出 MCP 根目录下的 .toml 配置和模板文件。

genify_plan、genify_diff 和 genify_apply 接受作为 MCP 工具参数直接传入的 JSON 配置。 无需临时 TOML 配置或模板文件。

{
  "config": {
    "rules": [
      {
        "type": "replace",
        "path": "src/application.rs",
        "replace": "old text",
        "content": "new text"
      }
    ]
  },
  "root": "."
}

支持的规则类型：

类型	字段
write	path、content、if_exists（overwrite、error 或 skip）
delete	path
rename / move	from、to
copy	from、to
mkdir	path
chmod	path、mode
append / append_once / prepend	path、content
insert_before / insert_after	path、marker、content
replace / replace_or_append	path、replace、content、可选的 replace_all、可选的 expected_matches
managed_block	path、start_marker、end_marker、content

默认情况下，replace 会严格校验：当 replace_all 为 false 或未提供时，如果正则匹配数不等于 expected_matches，操作就会失败；expected_matches 默认为 1。

支持的规则示例：

{
  "config": {
    "rules": [
      {
        "type": "write",
        "path": "new/file.rs",
        "content": "...",
        "if_exists": "error"
      }
    ]
  }
}

{
  "config": {
    "rules": [
      {
        "type": "append_once",
        "path": "README.md",
        "content": "..."
      }
    ]
  }
}

{
  "config": {
    "rules": [
      {
        "type": "managed_block",
        "path": "README.md",
        "start_marker": "",
        "end_marker": "",
        "content": "..."
      }
    ]
  }
}

{
  "config": {
    "rules": [
      {
        "type": "insert_after",
        "path": "README.md",
        "marker": "## Usage",
        "content": "..."
      }
    ]
  }
}

{
  "config": {
    "rules": [
      {
        "type": "move",
        "from": "old/file.rs",
        "to": "new/file.rs"
      }
    ]
  }
}

当配置缺失或无效时，genify_validate_config 会返回结构化的 hint.minimal_config 和各操作的示例。

支持的变量类型

类型	描述	CLI 交互式支持
String	文本值	✅ 支持
Integer	整数	✅ 支持
Float	小数	✅ 支持
Boolean	true 或 false	✅ 支持
Array	值列表	✅ JSON 输入
Map	键值对	✅ JSON 输入

注意： 对于 Array 和 Map，请在提示时输入 JSON，或使用 --props-json 预先提供。

代码

fn main() {
    genify::generate(
        Path::new("."),
        &genify::parse_toml(
            fs::read_to_string("example.toml")
                .unwrap()
                .as_str(),
        )
        .expect("The config should be valid"),
        Some(vec![(
            "value".to_string(),
            genify::Value::String("val".to_string()),
        )]),
    )
    .expect("The generation should be successful");
}

许可证

• MIT 许可证

贡献

CONTRIBUTING.md