Skip to main content

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

architect_c4_mcp-0.3.7.tar.gz (261.4 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

architect_c4_mcp-0.3.7-cp314-cp314-win_amd64.whl (2.4 MB view details)

Uploaded CPython 3.14Windows x86-64

architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded CPython 3.14musllinux: musl 1.2+ x86-64

architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_aarch64.whl (2.8 MB view details)

Uploaded CPython 3.14musllinux: musl 1.2+ ARM64

architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.17+ x86-64

architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded CPython 3.14manylinux: glibc 2.17+ ARM64

architect_c4_mcp-0.3.7-cp314-cp314-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded CPython 3.14macOS 11.0+ ARM64

architect_c4_mcp-0.3.7-cp313-cp313-win_amd64.whl (2.4 MB view details)

Uploaded CPython 3.13Windows x86-64

architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ x86-64

architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_aarch64.whl (2.8 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ ARM64

architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ x86-64

architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.17+ ARM64

architect_c4_mcp-0.3.7-cp313-cp313-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded CPython 3.13macOS 11.0+ ARM64

architect_c4_mcp-0.3.7-cp312-cp312-win_amd64.whl (2.4 MB view details)

Uploaded CPython 3.12Windows x86-64

architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded CPython 3.12musllinux: musl 1.2+ x86-64

architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_aarch64.whl (2.8 MB view details)

Uploaded CPython 3.12musllinux: musl 1.2+ ARM64

architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ x86-64

architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.17+ ARM64

architect_c4_mcp-0.3.7-cp312-cp312-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded CPython 3.12macOS 11.0+ ARM64

architect_c4_mcp-0.3.7-cp311-cp311-win_amd64.whl (2.4 MB view details)

Uploaded CPython 3.11Windows x86-64

architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_x86_64.whl (2.9 MB view details)

Uploaded CPython 3.11musllinux: musl 1.2+ x86-64

architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_aarch64.whl (2.8 MB view details)

Uploaded CPython 3.11musllinux: musl 1.2+ ARM64

architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (2.6 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ x86-64

architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (2.6 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.17+ ARM64

architect_c4_mcp-0.3.7-cp311-cp311-macosx_11_0_arm64.whl (2.4 MB view details)

Uploaded CPython 3.11macOS 11.0+ ARM64

File details

Details for the file architect_c4_mcp-0.3.7.tar.gz.

File metadata

  • Download URL: architect_c4_mcp-0.3.7.tar.gz
  • Upload date:
  • Size: 261.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: maturin/1.14.1

File hashes

Hashes for architect_c4_mcp-0.3.7.tar.gz
Algorithm Hash digest
SHA256 207a0aa996725cce267456894669ba628460aa55bd6ed6295c3c5b5c7ba50369
MD5 b0f63ea14aee6cbe71d20670b01906ea
BLAKE2b-256 1886027325da245ae83cdc89aa076735de2db535ec6fdaf04df8c02837707b21

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp314-cp314-win_amd64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp314-cp314-win_amd64.whl
Algorithm Hash digest
SHA256 69451f150d7e34027824434a396d2274f1a87c81df730adb3fb6e0a5ef44cde0
MD5 1402335567ceced01bd07a3b4d67dca7
BLAKE2b-256 98aa02f2dff7ff45ec7341a474921d0617bd24455100169d5140aa06b8a3ab01

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 b94082ce75f4584a9186931a2eb00f74a5be3864f4517991572b02638201b531
MD5 cbc58dc6db12591874e6aa809c740aad
BLAKE2b-256 0ad45e25994ee699638248098ac5ed97961001818db8cd01af73947a8a448729

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 d57dbaf385385165e6a243505384948a526149feceac7512821cccacc14d6e58
MD5 868b69ff31a7078b5419867c4e1e51af
BLAKE2b-256 b70c902a27537f2dd79be8e16053ce20374efe761235ac4f52e9158c227b6084

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 8cf7be2326358379c863123aea16260e7bd076a31135f6fcc6d5123793dec50a
MD5 c5bb6413336b883840addacc67655b3d
BLAKE2b-256 c7bc876d2c76b968df180e6490a2ad2e2c7c99bb1ec1abd64ea181ab45153ee5

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 e1f3d0ab9ed523a0c96626e7c54ae2b403ea27c6af36e618d6cb960a8e9c35e2
MD5 4cb3d9ae30b16487bef5982fd17e0221
BLAKE2b-256 99b0e5d03d34db5b38f24a187cebca7fe79e4371522ce3f4f4501970d9ffadf3

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp314-cp314-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp314-cp314-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0eb1a10258653393ef7e11542163ab892e552023fb2e91870212060101c44c0f
MD5 c199b61ead15ee7021a9f9c61deb43fb
BLAKE2b-256 7a2cf2bae71d5fc78d1a1e0c3e9a7d4a33ada415a36162ad781580b9fbf0e18f

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp313-cp313-win_amd64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp313-cp313-win_amd64.whl
Algorithm Hash digest
SHA256 408c1f7abb75df3d34586afec1e4d1c2754b255e6c551f1df9975aaba37af327
MD5 81e5c0b564b20220720c61014e19a6d9
BLAKE2b-256 a9a924abc2b5ac0e45f9dd31dc4cc1fbd86e888c76882736d4f330560b05925a

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 b3f168a6f2f063ed2c31826ef8981f3421a584ed88db7cff92cc658956457153
MD5 822942bf3c4b4dd8e8e1dd2368ec12fc
BLAKE2b-256 05c0aa8eeadaa75402411814d20b154b9def2c074a1aa5dedcafafe8d844bf5a

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 2004409f218d1a4c0258eca7ca0c085ff9676d85b7356e8a93226a75ee9f9521
MD5 f9c3bda369490fa7f317dc564ed05c7c
BLAKE2b-256 1f74da002d6b073b458a9b433fc7b22269aac0754c697de3d5619f2718b3f5b6

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 d041b6c9670093318f637d40b753ac1021dd31c2d8e7a58ffcc9fc9c3be488f5
MD5 69b426cfd5fa964ec59d0a3aa619c96b
BLAKE2b-256 722d0ca979b2d8487bad38182933717b9671680941b2b5b951aac1c8fcfbc1b5

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 eeefd276c91cf64f07e0bb66674327a128c543599bd06abfcc2c702888953660
MD5 18175b3e69fcb153808d56fe86deb17b
BLAKE2b-256 dc069b7b0ebe8dfae89855b0d5ddd4fbf29fb6268a6854722dbb5bfe2984a145

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp313-cp313-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp313-cp313-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 5388662e9c61b9a1fb1521ba52ad8d215ef7e55831fa138b34b32a2040b9d775
MD5 3234c057bf14a711080699559128a8ef
BLAKE2b-256 b1bfc8b8eb55216ffe8a96f720bfbb3ad7e2a7f7f87c657a1f475b1ec169b2c7

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp312-cp312-win_amd64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp312-cp312-win_amd64.whl
Algorithm Hash digest
SHA256 98e8e4d56bf414a1bef7bf58b36d371b9db64658904985fcb81ffc3543f5e4a4
MD5 e32392a5eae5a202244eba4afc7f5309
BLAKE2b-256 8f1063b2eb3f1f9a52b217233bc99be697e09f9a4659e5d436af84a7a3a4e6a5

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 2e12227eff7477f49a9251f0d174b315265e29bbc46e6406cd802ae05cc8d40f
MD5 e1d629ed18aa8f743790cd39cdb47769
BLAKE2b-256 e718d5b719b36f421581a3c2a963a8199f42f534c330702357073905713a3290

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 ca13178736363757b400aeba79116bdc24a81245c2e6057b1ca2051304dc893f
MD5 e9dcf7a0e55fa1839141c2a0ddfe6297
BLAKE2b-256 ea6c292d27248b68de0aaadb2d5d39fd7b2a08afc09a8e06b620296bcfc417be

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 df472004f6604116e1b347c47ad960401c27e1ce310e9598f80c83ac5a4fbe0e
MD5 018e58116f59e892d514012a888b4d57
BLAKE2b-256 2f25416c2cfe91553984a2e99c8e616b7c6102a254ff143e26339853c2e4610e

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 c3cde189234e4e33d1b7f3b6935bf00669fa9d09572bd09dc19a85a829256444
MD5 ee6717e138ba8717ca018adfa99a2019
BLAKE2b-256 73f9a4847778778caaa8e4287a5a786a10f2e96f35e67032faaeaf3f2bb5b7b7

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp312-cp312-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp312-cp312-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 0c5ef828cfd5bcc7e736226bf227155b9f35bd16928afa1426417a45331db758
MD5 dc45305ef8467b58ee0d7f1085240891
BLAKE2b-256 9cb53ad75ba60cd2b86fc60fa15e822fded4f364b580efbca12c6085a91d5455

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp311-cp311-win_amd64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp311-cp311-win_amd64.whl
Algorithm Hash digest
SHA256 342b6a47da5e600763a0463a8cf22742ab014b12b5e94baded0cff7d62824996
MD5 e7b3fcc4d6464a489504f4c35561c372
BLAKE2b-256 b6e76af615f4d2280323313ec741c9ec385bed97facc4a8c7febc2511c5890d5

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 c882ad0749833d17541cf63a1771a3e85dd22f36dbb783a8e7a05106f82aa2b4
MD5 7048c40988818486851baeb96843e474
BLAKE2b-256 b24a6267b3d980849b23e7d9d1e6035991fb22bc45df1d4a439db8ec9c9d94f2

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_aarch64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_aarch64.whl
Algorithm Hash digest
SHA256 193d8e72d0375d7a32caa6a24dae6968815c0b4f6a5afcae76da020d103930f4
MD5 9631c12383ae0406419588c859cfb1bb
BLAKE2b-256 b248ca9d859ebadfda532a37de84df96f1174fc8d9eaab820c200d3ce558334a

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 fe0e55017d71b5f8adc87fdbeaee77737e4c9aee4bf9b099a1482f31c21d0f7a
MD5 f910135fb5a071db7cf22e4ce56f0d8d
BLAKE2b-256 3ca2d91fa17908883af2c26fcb188c3a3c812ea732927e4d2428f817069d376e

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 0916b330a9cd138be594edaf4edd75275f9ffdd78707f349b2960203fe5b2275
MD5 5e3de94c6ebead0c733f350015af4eec
BLAKE2b-256 4fb93f218690c53ca9e06761f3474e093b90ff6401c27427384ad35f6bba834b

See more details on using hashes here.

File details

Details for the file architect_c4_mcp-0.3.7-cp311-cp311-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for architect_c4_mcp-0.3.7-cp311-cp311-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 94e5c1d49dc788bb1ad69c7097f8326ae3d8b823cfcce6392fd30fde2ea49ae8
MD5 cc4fe8abbd8faf609d1dc46ac3ba9ffc
BLAKE2b-256 4b91a48a5085fdfd7b4b1d8b063effee3c9641c37f5bac395f4a50b6cd62c593

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.3.7 This release

25 files

0.3.6

25 files

0.3.4

13 files

0.3.3

13 files

0.3.2

13 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page