nntrivi2001
17d56d0e01
Clean break, no compatibility alias. Renames the product name, the CLI binary (`ccam` -> `agenthub`), the env var prefix (`CCAM_` -> `AGENTHUB_`), the Prometheus metric namespace (`ccam_*` -> `agenthub_*`), the tmux session prefix (`ccam-lane-<id>` -> `agenthub-lane-<id>`), the per-repo runtime profile directory (`.ccam/profile` -> `.agenthub/profile`), the lanes state root (`~/.claude/ccam-lanes` -> `~/.claude/agenthub-lanes`), the bundled plugins (`plugins/ccam*` -> `plugins/agenthub*`) and their slash commands (`/ccam-doctor` -> `/agenthub-doctor`, `/ccam:*` -> `/agenthub:*`). Because there is no alias, an existing install has to be updated by hand: rename its `.ccam/profile` directory and any `CCAM_*` variables, and reinstall the plugin under its new name. Two other name families are deliberately left alone here, since they are not just strings: the `Claude-Code-Monitor` repository/marketplace name, and the `agent-dashboard` npm package plus its `~/.claude/agent-dashboard` runtime directory, which holds the live database and needs a migration rather than a rename. Verified: server 1406/1406, client 459/459, `grep -i ccam` clean across tracked files, `openapi.yaml` regenerated (95 paths, unchanged count).
66 lines
2.7 KiB
Markdown
66 lines
2.7 KiB
Markdown
---
|
|
description: >
|
|
Audit the configured MCP servers (user + project scope) via the Agent
|
|
Monitor Config Explorer API: transport (stdio vs http), command/args and env
|
|
variable names, headers, and the source file each definition came from.
|
|
Reads /api/cc-config/mcp. Use when reviewing MCP integrations for hygiene,
|
|
duplication, or unexpected transports.
|
|
---
|
|
|
|
# MCP Audit
|
|
|
|
Inventory and audit every Model Context Protocol server the user has
|
|
configured — both user-scope and project-scope — read through the Agent Monitor
|
|
dashboard at `http://localhost:4820`.
|
|
|
|
## Input
|
|
|
|
The user provides: **$ARGUMENTS**
|
|
|
|
This may be:
|
|
- empty — audit all MCP servers (default).
|
|
- a server name fragment — focus on matching servers.
|
|
- "stdio" / "http" — restrict to one transport kind.
|
|
|
|
## Data Sources
|
|
|
|
| Endpoint | Returns |
|
|
|----------|---------|
|
|
| `GET /api/cc-config/mcp` | `{ user:[…], projectScoped:[…] }`. Each server: `{ name, source, kind }` where `kind` is `stdio` (with `command, args, envNames`), `http` (with `url, headers`), or `unknown`. `source` names the file the definition came from (e.g. `~/.claude.json (top-level)`, `~/.claude.json (projects[<root>])`, `~/.claude/settings.json`) |
|
|
|
|
## Report Sections
|
|
|
|
### 1. Server inventory
|
|
List every server from `user` and `projectScoped`. For each show `name`,
|
|
`source`, `kind`, and the transport detail:
|
|
- **stdio** — the `command`, its `args`, and the `envNames` (names only — values
|
|
are not exposed by the API).
|
|
- **http** — the `url` and the `headers` key names (values not exposed).
|
|
- **unknown** — a definition the server could not classify; flag it for review.
|
|
|
|
### 2. Scope split & duplication
|
|
Separate user-scope from project-scope servers. Flag any `name` that appears in
|
|
both scopes (project may shadow user) and any duplicate definitions across
|
|
source files.
|
|
|
|
### 3. Hygiene flags
|
|
- **Unknown transport** — servers with `kind: "unknown"` (malformed or
|
|
unsupported definition).
|
|
- **Env reliance** — stdio servers with many `envNames`; note they depend on
|
|
environment variables being present at launch.
|
|
- **Remote endpoints** — http servers; surface the `url` host so the user can
|
|
confirm they trust the remote.
|
|
|
|
## Output
|
|
|
|
- Section 1 as a table (`Scope | Name | Kind | Transport detail | Source`).
|
|
- Env names and header names listed by name only — never invent or print values
|
|
(the API does not expose them).
|
|
- Cite only fields the API returned — never fabricate servers, commands, or
|
|
hosts.
|
|
- Note: MCP servers are read-only via the Config Explorer (they are written
|
|
concurrently by the running CLI); edit their definitions in the source file
|
|
named by `source`.
|
|
- If the dashboard is unreachable at `http://localhost:4820`, say so and tell
|
|
the user to start it with `npm start` from the repo root.
|