MCP server for Compos architectural memory
Project description
compos-mcp
MCP (Model Context Protocol) server for Compos — gives AI builders architectural context about your codebase.
Install
Easiest path — Claude Code plugin (auto-configures this server):
/install-plugin github:fer46/compos-plugin
Manual install for other MCP clients:
uv tool install compos-mcp
compos-mcp # starts the server (stdio transport)
Wire into your MCP client's config; the server auto-discovers .compos/ by walking up from its working directory.
Requires Python 3.13+ and a project with compos init already run (use compos-cli for that).
Tools exposed
Read (orient before changes): get_component_context, get_blast_radius, list_components, get_component, list_versions, get_snapshot, get_constraints_for_components, get_decisions_for_component, get_relationships_for_component, get_system_map.
Write (log architectural reality as you work): register_component / update_component / remove_component, same pattern for relationship / constraint / risk. Decisions use log_decision / update_decision / remove_decision.
Evaluate: evaluate_proposed_change — pre-flight check for structural changes.
Documentation
Full tool reference: https://github.com/fer46/compos.
License
MIT.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file compos_mcp-0.1.1-py3-none-any.whl.
File metadata
- Download URL: compos_mcp-0.1.1-py3-none-any.whl
- Upload date:
- Size: 45.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
47454e4c676d7e96d5108cc58c3c3d69389cb3f5834449a5f5cba8bec594a150
|
|
| MD5 |
edc9d91e82c8bf5ca710046175ecb342
|
|
| BLAKE2b-256 |
d2d909de407f62f782cb57698c901886f7dbdb74fa77e0c24d6bbfbcdda2b08e
|
Provenance
The following attestation bundles were made for compos_mcp-0.1.1-py3-none-any.whl:
Publisher:
publish.yml on fer46/compos-platform
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
compos_mcp-0.1.1-py3-none-any.whl -
Subject digest:
47454e4c676d7e96d5108cc58c3c3d69389cb3f5834449a5f5cba8bec594a150 - Sigstore transparency entry: 1322035923
- Sigstore integration time:
-
Permalink:
fer46/compos-platform@04ecbb3394b8f40cd0b78070c90e612690da8db3 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/fer46
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@04ecbb3394b8f40cd0b78070c90e612690da8db3 -
Trigger Event:
workflow_dispatch
-
Statement type:
