Skip to main content
Glama

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.

Related MCP server: OKF Knowledge 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.

Related MCP Connectors

Related MCP Servers