mq-mcp Integration Map

mq-mcp connects local MCP tools with repo-aware workflows. Together with mq-hal and repo-signal, it becomes a local assistant stack for safe repository analysis and publish-quality checks.

mq-mcp + mq-hal + repo-signal
= local AI assistant + safe repo analysis + publish-quality checks

local-first read-only by default repo-aware publish readiness

Project roles

Project	Role
`mq-mcp`	Local MCP server, bridge, and safe tool layer.
`mq-hal`	Local assistant / operator layer for asking, auditing, and reporting.
`repo-signal`	Repository quality, release readiness, and publishability checks.

Main integration tools

MCP tool	Purpose	Safety profile
`hal_repo_report`	Runs a read-only mq-hal repo report.	Read-only
`repo_signal_analyze`	Runs repo-signal analysis on a local repository.	Read-only
`repo_signal_checklist`	Runs repo-signal publish checklist on a local repository.	Read-only
`tool_safety_report`	Shows documented MCP tool safety classes.	Read-only
`list_local_repos`	Lists registered local repos from `MQ_MCP_LOCAL_REPOS`.	Read-only
`open_repo_terminal`	Opens a registered repo in Terminal.	Local action

Example repo registration

export MQ_MCP_LOCAL_REPOS="/Users/mansys/repo-signal,/Users/mansys/mq-hal,/Users/mansys/macos-scripts"

Example Bridget prompts

bridget "run hal repo report for mq-mcp"
bridget "run repo signal analyze for mq-mcp"
bridget "run repo signal checklist for mq-mcp"
bridget "show tool safety report"

Safety rules

Default to read-only tools.
Keep repo access scoped through registered local repositories.
Do not run destructive commands without explicit approval.
Do not commit secrets, tokens, private paths, or .env files.
Document write-capable tools in docs/TOOL_SAFETY.md.
Validate documentation whenever a new MCP tool is added.

v0.3.0 direction

safer local assistant workflows

Recommended release contents: integration docs, validation guard, safety map, Bridget demo prompts, and clearer repo registration examples.