Openacr MCP

OpenACR MCP服务器

MCP（模型上下文协议）服务器，用于封装 OpenACR CLI工具，让AI代理查询模式，编写新类型/字段/枚举，生成C++代码，并发现生成的API。45个工具，165个测试。

先决条件

• Python 3.11+
• OpenACR 建造和安装（与 bin/acr, bin/acr_ed, bin/amc, bin/abt)

设置

git clone https://github.com/aaslyan/openacr-mcp.git
cd openacr-mcp
python -m venv venv
source venv/bin/activate
pip install -e ".[dev]"

配置Claude代码

复制示例配置并编辑路径：

cp .mcp.json.example .mcp.json

编辑 .mcp.json 指向您的本地路径：

{
  "mcpServers": {
    "openacr": {
      "command": "/path/to/openacr-mcp/venv/bin/python",
      "args": ["-m", "openacr_mcp", "--openacr-dir", "/path/to/openacr"],
      "cwd": "/path/to/openacr-mcp"
    }
  }
}

这 --openacr-dir 标志默认为 ~/openacr 如果省略。

独立运行

python -m openacr_mcp --openacr-dir /path/to/openacr

运行测试

PYTHONPATH=. pytest -v

测试套件包括单元测试（始终运行）和集成测试（需要在以下位置安装OpenACR ~/openacr，否则跳过）。

工具

模式查询与探索（17个工具）

模式创作（21个工具）

代码生成和发现（5个工具）

帮助和示例（2个工具）

什么 create_ctype 自动创建

对于ssimdb命名空间， create_ctype 自动插入：

• dmmeta.ssimfile --支持数据存储的ssimfile
• dmmeta.cfmt 随着 read:Y print:Y --生成 ReadStrptrMaybe/Print finput将数据加载到exe目标中所需的函数

无需手动接线。

典型工作流程

1. create_target("mydb", "ssimdb")        -- create namespace
2. create_ctype("mydb", "Status")         -- create enum type
3. create_fconst("mydb.Status", "active")          -- add enum values (auto-derives pkey)
4. create_ctype("mydb", "Record")         -- create struct
5. create_field("mydb.Record", "status", "mydb.Status", "Pkey")  -- add FK field
6. run_amc()                              -- generate C++
7. get_functions("mydb")                  -- discover generated API
8. get_usage_examples("mydb")            -- C++ code examples for each type

建筑

openacr-mcp/
├── openacr_mcp/
│   ├── __init__.py
│   ├── __main__.py
│   ├── server.py          # MCP server — 45 tools + embedded workflow knowledge
│   ├── acr_client.py      # Subprocess wrapper for acr/acr_ed/amc/abt/acr_in/amc_vis
│   └── header_parser.py   # C++ header parser for generated code discovery
├── tests/
│   ├── test_server.py     # 128 tests (unit + integration)
│   ├── test_acr_client.py # 20 tests
│   └── test_header_parser.py # 17 tests
├── .mcp.json.example      # Template MCP config (copy to .mcp.json)
└── pyproject.toml