Contributing

git clone https://github.com/mindroom-ai/matrix-mcp.git
cd matrix-mcp
uv sync --extra dev --group docs

uv run pytest

uv run ruff check .
uv run ruff format --check .
uv run mypy src tests
uv run ty check
uv build

uv run prek run --all-files

uv run zensical build

src/matrix_mcp/
├── auth.py                Matrix login and SSO callback handling
├── cli.py                 Typer CLI
├── config.py              Stored credentials and config paths
├── conversation_tools.py  History, message, membership, media, and catch-up tools
├── e2ee.py                End-to-end encryption for the local device
├── hosted_auth.py         OAuth for authenticated HTTP mode
├── hosted_server.py       Authenticated HTTP tool registration
├── http_headers.py        Static and command-generated HTTP headers
├── id_state.py            Stable numeric refs for rooms and events
├── matrix_client.py       Matrix client wrapper
├── matrix_events.py       Room history, event context, and event sends
├── matrix_http.py         Bounded Matrix HTTP requests
├── matrix_media.py        Media upload and download
├── matrix_rooms.py        Invitations, membership, and unread catch-up
├── mcp_server.py          Local (stdio) tool registration
└── tls.py                 TLS defaults