agent-mcp
Declare every MCP server once and install it into Claude Code, Codex, OpenCode and Pi on macOS, Arch and Debian.
What it does
- One manifest.
servers.yamldeclares every MCP server and the dependencies it needs.servers.schema.jsondefines the format, andtask manifest:checkvalidates it. - Installs into four harnesses.
scripts/installer.pyregisters every server into each harness found onPATH: Claude Code, Codex, OpenCode and Pi. - Dry-run preview.
task install -- --dry-runandtask sync -- --dry-runprint the plan per harness and write nothing, not even the state file or backups. - Undo.
task uninstallremoves only the entries this repository recorded in its state file. Entries added by hand are never changed. - Secrets with sops and age.
secrets/secrets.sops.yamlholds the Telegram API id and hash, encrypted. Both tools run in one-off containers, so a host needs only Docker. - Verified in CI. The manifest, the installer tests, the secrets store and the Compose file are checked on every push and pull request. See CI and brand.
Where to go next
- Getting started: prerequisites and the first install.
- Operator guide: setup per machine, day-to-day commands, undo and troubleshooting.
- Servers: the servers the manifest declares.
- CI and brand: what CI checks and where the brand assets come from.