mcp-audit — скилл для Claude Code: что делает и как установить
Проверяет конфигурации MCP-серверов в окружении пользователя и проекта через Agent Monitor. Помогает найти дубликаты, некорректные транспорты и внешние URL.
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-audit -a claude-codeЧто делает mcp-audit
Скилл запрашивает эндпоинт GET /api/cc-config/mcp дашборда Agent Monitor по адресу http://localhost:4820. Он собирает список серверов Model Context Protocol из глобальных и проектных настроек (например, ~/.claude.json или ~/.claude/settings.json), разделяя их по типам транспорта stdio и http.
В итоговой таблице отображаются имена серверов, файлы-источники, параметры запуска и список ключей заголовков или переменных окружения. Значения секретов API не отдаёт, поэтому скилл выводит только имена. Инструмент отмечает пересечения имён между проектом и профилем пользователя, выявляет тип unknown и подсвечивает хосты удалённых эндпоинтов.
Скилл работает только на чтение, поэтому менять конфигурации придётся вручную в исходных JSON-файлах. Если дашборд Agent Monitor не запущен локально через команду npm start, опрос API завершится с ошибкой.
Какие задачи решает
- найти дублирующиеся MCP-серверы между настройками проекта и пользователя
- проверить адреса удалённых HTTP-серверов на безопасность
- выявить повреждённые конфигурации с неизвестным типом транспорта
- составить таблицу задействованных переменных окружения и аргументов запуска
Примеры запросов агенту
- Проверь все настроенные MCP-серверы
- Выполни аудит серверов с транспортом http
- Найди дубликаты MCP-конфигураций для проекта
Как установить mcp-audit
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-audit -a claude-code2Вручную: положить файлы
~/.claude/skills/mcp-audit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/mcp-audit/
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-audit -a codex2Вручную: положить файлы
.agents/skills/mcp-audit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-audit -a cursor2Вручную: положить файлы
.cursor/skills/mcp-audit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install hoangsonww/Claude-Code-Agent-Monitor mcp-audit2Вручную: положить файлы
.github/skills/mcp-audit/SKILL.md1Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-audit -a gemini-cli2Командой платформы
gemini skills install https://github.com/hoangsonww/Claude-Code-Agent-Monitor --path plugins/ccam-config/skills/mcp-auditВручную: положить файлы
.devin/skills/mcp-audit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-audit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о mcp-audit
Как установить mcp-audit в Claude Code?
Выполните команду npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill mcp-audit -a claude-code. Также можно подключить файл по пути ~/.claude/skills/mcp-audit/SKILL.md.
Что делает mcp-audit?
Скилл опрашивает API Agent Monitor и формирует сводный отчёт по активным MCP-серверам. Он выводит источники настроек, типы транспорта и предупреждает о конфликтах в областях видимости.
Что требуется для запуска аудита?
Необходимо поднять локальный сервис Agent Monitor по адресу http://localhost:4820 с помощью npm start из корня его репозитория. Без работающего дашборда скилл не сможет прочитать эндпоинт /api/cc-config/mcp.
Исходный текст
SKILL.md · MIT
---
name: mcp-audit
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.
© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor