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.
Metadata
Release files for architect-c4-mcp 0.3.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| architect_c4_mcp-0.3.7.tar.gz | 261.4 kB | Without provenance | Details for architect_c4_mcp-0.3.7.tar.gz |
Built distributions (wheels)
Total release size: 63.1 MB
Release files / architect_c4_mcp-0.3.7.tar.gz
| Download URL | architect_c4_mcp-0.3.7.tar.gz |
|---|---|
| Size | 261.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
207a0aa996725cce267456894669ba628460aa55bd6ed6295c3c5b5c7ba50369
|
|
BLAKE2b-256 checksum How to use checksums |
1886027325da245ae83cdc89aa076735de2db535ec6fdaf04df8c02837707b21
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp314-cp314-win_amd64.whl
| Download URL | architect_c4_mcp-0.3.7-cp314-cp314-win_amd64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.14 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
69451f150d7e34027824434a396d2274f1a87c81df730adb3fb6e0a5ef44cde0
|
|
BLAKE2b-256 checksum How to use checksums |
98aa02f2dff7ff45ec7341a474921d0617bd24455100169d5140aa06b8a3ab01
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_x86_64.whl
| Download URL | architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.14 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
b94082ce75f4584a9186931a2eb00f74a5be3864f4517991572b02638201b531
|
|
BLAKE2b-256 checksum How to use checksums |
0ad45e25994ee699638248098ac5ed97961001818db8cd01af73947a8a448729
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_aarch64.whl
| Download URL | architect_c4_mcp-0.3.7-cp314-cp314-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.14 Linux musl 1.2+ ARM64 |
|
SHA-256 checksum How to use checksums |
d57dbaf385385165e6a243505384948a526149feceac7512821cccacc14d6e58
|
|
BLAKE2b-256 checksum How to use checksums |
b70c902a27537f2dd79be8e16053ce20374efe761235ac4f52e9158c227b6084
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
8cf7be2326358379c863123aea16260e7bd076a31135f6fcc6d5123793dec50a
|
|
BLAKE2b-256 checksum How to use checksums |
c7bc876d2c76b968df180e6490a2ad2e2c7c99bb1ec1abd64ea181ab45153ee5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | architect_c4_mcp-0.3.7-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.14 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
e1f3d0ab9ed523a0c96626e7c54ae2b403ea27c6af36e618d6cb960a8e9c35e2
|
|
BLAKE2b-256 checksum How to use checksums |
99b0e5d03d34db5b38f24a187cebca7fe79e4371522ce3f4f4501970d9ffadf3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp314-cp314-macosx_11_0_arm64.whl
| Download URL | architect_c4_mcp-0.3.7-cp314-cp314-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.14 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
0eb1a10258653393ef7e11542163ab892e552023fb2e91870212060101c44c0f
|
|
BLAKE2b-256 checksum How to use checksums |
7a2cf2bae71d5fc78d1a1e0c3e9a7d4a33ada415a36162ad781580b9fbf0e18f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp313-cp313-win_amd64.whl
| Download URL | architect_c4_mcp-0.3.7-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
408c1f7abb75df3d34586afec1e4d1c2754b255e6c551f1df9975aaba37af327
|
|
BLAKE2b-256 checksum How to use checksums |
a9a924abc2b5ac0e45f9dd31dc4cc1fbd86e888c76882736d4f330560b05925a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_x86_64.whl
| Download URL | architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.13 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
b3f168a6f2f063ed2c31826ef8981f3421a584ed88db7cff92cc658956457153
|
|
BLAKE2b-256 checksum How to use checksums |
05c0aa8eeadaa75402411814d20b154b9def2c074a1aa5dedcafafe8d844bf5a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_aarch64.whl
| Download URL | architect_c4_mcp-0.3.7-cp313-cp313-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.13 Linux musl 1.2+ ARM64 |
|
SHA-256 checksum How to use checksums |
2004409f218d1a4c0258eca7ca0c085ff9676d85b7356e8a93226a75ee9f9521
|
|
BLAKE2b-256 checksum How to use checksums |
1f74da002d6b073b458a9b433fc7b22269aac0754c697de3d5619f2718b3f5b6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
d041b6c9670093318f637d40b753ac1021dd31c2d8e7a58ffcc9fc9c3be488f5
|
|
BLAKE2b-256 checksum How to use checksums |
722d0ca979b2d8487bad38182933717b9671680941b2b5b951aac1c8fcfbc1b5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | architect_c4_mcp-0.3.7-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.13 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
eeefd276c91cf64f07e0bb66674327a128c543599bd06abfcc2c702888953660
|
|
BLAKE2b-256 checksum How to use checksums |
dc069b7b0ebe8dfae89855b0d5ddd4fbf29fb6268a6854722dbb5bfe2984a145
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | architect_c4_mcp-0.3.7-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5388662e9c61b9a1fb1521ba52ad8d215ef7e55831fa138b34b32a2040b9d775
|
|
BLAKE2b-256 checksum How to use checksums |
b1bfc8b8eb55216ffe8a96f720bfbb3ad7e2a7f7f87c657a1f475b1ec169b2c7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp312-cp312-win_amd64.whl
| Download URL | architect_c4_mcp-0.3.7-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
98e8e4d56bf414a1bef7bf58b36d371b9db64658904985fcb81ffc3543f5e4a4
|
|
BLAKE2b-256 checksum How to use checksums |
8f1063b2eb3f1f9a52b217233bc99be697e09f9a4659e5d436af84a7a3a4e6a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_x86_64.whl
| Download URL | architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
2e12227eff7477f49a9251f0d174b315265e29bbc46e6406cd802ae05cc8d40f
|
|
BLAKE2b-256 checksum How to use checksums |
e718d5b719b36f421581a3c2a963a8199f42f534c330702357073905713a3290
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_aarch64.whl
| Download URL | architect_c4_mcp-0.3.7-cp312-cp312-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.12 Linux musl 1.2+ ARM64 |
|
SHA-256 checksum How to use checksums |
ca13178736363757b400aeba79116bdc24a81245c2e6057b1ca2051304dc893f
|
|
BLAKE2b-256 checksum How to use checksums |
ea6c292d27248b68de0aaadb2d5d39fd7b2a08afc09a8e06b620296bcfc417be
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
df472004f6604116e1b347c47ad960401c27e1ce310e9598f80c83ac5a4fbe0e
|
|
BLAKE2b-256 checksum How to use checksums |
2f25416c2cfe91553984a2e99c8e616b7c6102a254ff143e26339853c2e4610e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | architect_c4_mcp-0.3.7-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
c3cde189234e4e33d1b7f3b6935bf00669fa9d09572bd09dc19a85a829256444
|
|
BLAKE2b-256 checksum How to use checksums |
73f9a4847778778caaa8e4287a5a786a10f2e96f35e67032faaeaf3f2bb5b7b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | architect_c4_mcp-0.3.7-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
0c5ef828cfd5bcc7e736226bf227155b9f35bd16928afa1426417a45331db758
|
|
BLAKE2b-256 checksum How to use checksums |
9cb53ad75ba60cd2b86fc60fa15e822fded4f364b580efbca12c6085a91d5455
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp311-cp311-win_amd64.whl
| Download URL | architect_c4_mcp-0.3.7-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
342b6a47da5e600763a0463a8cf22742ab014b12b5e94baded0cff7d62824996
|
|
BLAKE2b-256 checksum How to use checksums |
b6e76af615f4d2280323313ec741c9ec385bed97facc4a8c7febc2511c5890d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_x86_64.whl
| Download URL | architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
c882ad0749833d17541cf63a1771a3e85dd22f36dbb783a8e7a05106f82aa2b4
|
|
BLAKE2b-256 checksum How to use checksums |
b24a6267b3d980849b23e7d9d1e6035991fb22bc45df1d4a439db8ec9c9d94f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_aarch64.whl
| Download URL | architect_c4_mcp-0.3.7-cp311-cp311-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 2.8 MB |
| Tags | CPython 3.11 Linux musl 1.2+ ARM64 |
|
SHA-256 checksum How to use checksums |
193d8e72d0375d7a32caa6a24dae6968815c0b4f6a5afcae76da020d103930f4
|
|
BLAKE2b-256 checksum How to use checksums |
b248ca9d859ebadfda532a37de84df96f1174fc8d9eaab820c200d3ce558334a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 |
|
SHA-256 checksum How to use checksums |
fe0e55017d71b5f8adc87fdbeaee77737e4c9aee4bf9b099a1482f31c21d0f7a
|
|
BLAKE2b-256 checksum How to use checksums |
3ca2d91fa17908883af2c26fcb188c3a3c812ea732927e4d2428f817069d376e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | architect_c4_mcp-0.3.7-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 2.6 MB |
| Tags | CPython 3.11 Linux glibc 2.17+ ARM64 |
|
SHA-256 checksum How to use checksums |
0916b330a9cd138be594edaf4edd75275f9ffdd78707f349b2960203fe5b2275
|
|
BLAKE2b-256 checksum How to use checksums |
4fb93f218690c53ca9e06761f3474e093b90ff6401c27427384ad35f6bba834b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Release files / architect_c4_mcp-0.3.7-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | architect_c4_mcp-0.3.7-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 2.4 MB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
94e5c1d49dc788bb1ad69c7097f8326ae3d8b823cfcce6392fd30fde2ea49ae8
|
|
BLAKE2b-256 checksum How to use checksums |
4b91a48a5085fdfd7b4b1d8b063effee3c9641c37f5bac395f4a50b6cd62c593
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
maturin/1.14.1
|
Security for architect-c4-mcp 0.3.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.