Metadata-Version: 2.4
Name: compos-mcp
Version: 0.1.1
Summary: MCP server for Compos architectural memory
Project-URL: Homepage, https://github.com/fer46/compos
Project-URL: Repository, https://github.com/fer46/compos
Project-URL: Issues, https://github.com/fer46/compos/issues
Project-URL: Documentation, https://github.com/fer46/compos#readme
Author: Fer Aliaga
License-Expression: MIT
Keywords: ai-tooling,architectural-memory,architecture,claude,llm,mcp,model-context-protocol
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.13
Requires-Dist: mcp
Requires-Dist: pydantic>=2.0
Description-Content-Type: text/markdown

# compos-mcp

MCP (Model Context Protocol) server for [Compos](https://github.com/fer46/compos) — gives AI builders architectural context about your codebase.

## Install

Easiest path — Claude Code plugin (auto-configures this server):

```text
/install-plugin github:fer46/compos-plugin
```

Manual install for other MCP clients:

```bash
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`](https://pypi.org/project/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.
