architect-c4

MCP-сервис рядом с вашим git-репозиторием: агент ведёт C4, ADR и потоки поведения как файлы в docs/.

ваш-репо/
  docs/
    model.toml
    adr/{id}.toml
    flows/{id}.toml

На диске продукта — только TOML. Запись идёт через очередь на Rust. История — git.

Подробнее: концепт · быстрый старт · инструменты · публикация

Установка

Нужен Python 3.11+. Rust не требуется.

uvx architect-c4-mcp --docs /abs/path/to/product/docs

или

uv tool install architect-c4-mcp
architect-c4-mcp --docs /abs/path/to/product/docs

пакет: https://pypi.org/project/architect-c4-mcp/

Альтернатива: образ ghcr.io/hewimetall/architect-c4-mcp.

Быстрый старт

uvx architect-c4-mcp \
  --docs /abs/path/to/product/docs \
  --public-base https://c4.example.com

Эквивалент через env: ARCHITECT_C4_DOCS (CLI --docs важнее).

HTTP:

uvx architect-c4-mcp \
  --docs /abs/path/to/product/docs \
  --transport http --host 127.0.0.1 --port 8766

• MCP: http://127.0.0.1:8766/mcp
• Viewer: http://127.0.0.1:8766/?layer=context

Cursor

{
  "mcpServers": {
    "architect-c4": {
      "command": "uvx",
      "args": [
        "architect-c4-mcp",
        "--docs",
        "/ABS/product/docs",
        "--public-base",
        "https://c4.example.com"
      ]
    }
  }
}

--docs и путь — два аргумента. В WSL: Unix-путь, не C:\….

Что умеет агент

Действие	Tools / prompts
Привязать docs/	bind_docs · prompt sidecar_onboard
Модель C4	upsert_element, upsert_relationship, validate_model · model_c4
ADR (GFM → .toml)	upsert_adr, set_adr_status · write_adr
Сценарии	upsert_flow, get_flow_diagram · write_flow
Ссылки на схемы	get_view_links, get_overview_diagram · validate_architecture

Промпты: https://gofastmcp.com/servers/prompts

Docker

docker pull ghcr.io/hewimetall/architect-c4-mcp:latest
docker run --rm -p 8766:8766 \
  -v /abs/path/to/product/docs:/docs \
  -e ARCHITECT_C4_DOCS=/docs \
  -e ARCHITECT_C4_TRANSPORT=http \
  ghcr.io/hewimetall/architect-c4-mcp:latest

Разработка

git clone https://github.com/hewimetall/architect-c4-mcp.git
cd architect-c4-mcp
uv sync --extra dev
uv run maturin develop
uv run architect-c4-mcp --docs ./examples/docs

CI

Событие	Что делает
push / PR	pytest, cargo test, lint, docker build
tag v*	coverage ≥93% (py+rust) → PyPI wheels, GitHub Release, GHCR

Лицензия

MIT — см. LICENSE.