KryptosAI/mcp-observatory

KryptosAI/mcp-observatory

от kryptosai
MCP Observatory — CI и безопасность для MCP-серверов. Сканирует совместимость, находит уязвимости и дрейф схем, предотвращает регрессии. Полезен разработчикам и командам безопасности, использующим ...

MCP Observatory

MCP Observatory

CI CodeQL Coverage Workflow npm GitHub stars License: MIT

More badges

OpenSSF Scorecard Dependabot npm provenance workflow npm weekly downloads Node >= 20 Smithery mcp-observatory MCP server All Contributors Gitee Stars Gitee Forks MCP Registry MCP Market MCP Hub China OpenTools Gitee

Secure the MCP servers you're building. MCP Observatory is the CI-native security tool for teams shipping custom MCP servers. Test during development, catch schema drift, simulate attacks, and generate compliance evidence — before agents depend on your servers.

Also available in Simplified Chinese.

Runtime enforcement: Use mcp-seatbelt to block dangerous MCP tool calls at runtime based on observatory scan results.

Get Started

Step-by-step setup guide · macOS, Windows, Linux · Node.js 20+ and npm (install Node.js LTS).

1. Run your first scan

Open Terminal or PowerShell in your project folder and paste:

npx -y @kryptosai/mcp-observatory@latest

This downloads Observatory and checks your first configured MCP server. With no configured server, it uses an included example. To try only that example, run npx -y @kryptosai/mcp-observatory@latest demo --example.

2. Read the result

The terminal shows the target, grade, findings, and saved receipt path. Failed checks are findings to review, not a request to pay. If connection failed, fix the startup command or credentials and rerun. A demo grade describes the example, not your own server.

Часто задаваемые вопросы

Инструменты были проиндексированы:
check_server

Используйте этот инструмент для тестирования конкретного MCP сервера перед установкой или после обновления. Запускает сервер по команде, проверяет все возможности и сохраняет артефакт запуска для будущего сравнения. Пример: check_server({ command: 'npx -y @modelcontextprotocol/server-everything' }). Используйте deep=true для вызова инструментов, security=true для анализа схем на уязвимости.

Параметры
  • argsstring[]

    Дополнительные аргументы для команды.

  • commandstringобязательный

    Команда для запуска MCP-сервера (например, 'npx -y @modelcontextprotocol/server-everything').

  • deepboolean

    Также вызывайте безопасные инструменты, чтобы проверить, что они выполняются.

  • securityboolean

    Проведите анализ безопасности схем инструментов.

ci_report

Генерирует отчёт о регрессии CI из артефактов выполнения.

Параметры
  • artifactsDirstring

    Каталог с артефактами запуска. По умолчанию — .mcp-observatory/runs/

diff_runs

Находит изменения между двумя проверками сервера. Сравнивает два артефакта запуска и выявляет регрессии (то, что сломалось), восстановления (то, что было исправлено), расхождение схем (добавленные/удалённые/изменённые параметры инструментов) и изменения статуса шлюзов. Необходимо после обновления сервера.

Параметры
  • basestringобязательный

    Путь к JSON-файлу артефакта базового запуска.

  • formatenum

    Формат вывода: 'markdown' (по умолчанию) или 'json'.

  • headstringобязательный

    Путь к JSON-файлу артефакта основного запуска.

get_history

Получает тренды health score для MCP серверов из истории выполнения.

Параметры
  • targetstring

    Отфильтруйте по конкретному целевому ID.

get_last_run

Возвращает последний запуск Observatory для сервера, включая разрешение/отказ рукопожатия из локальной квитанции. Учетная запись не требуется.

Параметры
  • targetIdstringобязательный

    ID цели, используемый для поиска последнего запуска (например, имя сервера или команда).

lock_verify

Проверяет, что работающие MCP-серверы всё ещё соответствуют ранее сохранённому lock-файлу. Обнаруживает расхождение схем, добавленные/удалённые инструменты и критические изменения.

Параметры
  • configstring

    Путь к файлу конфигурации MCP.

record

Используйте это, чтобы сохранить эталонное состояние работающего MCP-сервера. Записывает весь JSON-RPC трафик в файл кассеты, который можно воспроизвести офлайн (без сервера) или использовать для проверки, что будущие версии ничего не сломали. Как VCR для MCP.

Параметры
  • argsstring[]

    Дополнительные аргументы для команды.

  • commandstringобязательный

    Команда для запуска MCP-сервера.

replay

Используйте это для тестирования сервера без его запуска. Воспроизводит ранее записанную кассету в офлайн-режиме и выполняет все проверки на основе записанных ответов. Полезно в CI или когда живой сервер недоступен.

Параметры
  • cassettestringобязательный

    Путь к JSON-файлу кассеты.

scan

Используйте для проверки работоспособности всех ваших MCP-серверов. Автоматически обнаруживает серверы из конфигурационных файлов Claude, подключается к каждому и проверяет корректность ответов tools/prompts/resources. Используйте с deep=true, чтобы также вызывать tools и подтверждать их выполнение. Возвращает статус pass/fail для каждого сервера.

Параметры
  • configstring

    Путь к конкретному файлу конфигурации MCP. Если не указан, сканирует расположения по умолчанию.

  • deepboolean

    Также вызывайте безопасные инструменты, чтобы проверить, что они выполняются.

  • securityboolean

    Проведите анализ безопасности схем инструментов.

score_server

Выполняет быструю оценку здоровья MCP-сервера. Запускает все проверки (возможности, вызов инструментов, безопасность) и возвращает оценку от 0 до 100 с буквенным рейтингом от A до F и детальным разбором по соответствию протоколу, качеству схемы, безопасности, надёжности и производительности.

Параметры
  • argsstring[]

    Дополнительные аргументы для команды.

  • commandstringобязательный

    Команда для запуска MCP-сервера.

suggest_servers

Используйте это при настройке проекта или когда сомневаетесь, какие MCP-серверы добавить. Сканирует рабочую директорию на наличие языков, фреймворков, баз данных и облачных провайдеров, перечисляет уже настроенные серверы и сверяется с реестром MCP, чтобы порекомендовать недостающие серверы.

Параметры
  • cwdstring

    Рабочая директория для сканирования сигналов окружения. По умолчанию используется process.cwd().

verify

Используйте его после обновления сервера, чтобы убедиться, что ничего не сломалось. Подключается к работающему серверу, отправляет те же запросы из записанной кассеты и сравнивает ответы. Точно сообщает, что изменилось: добавленные инструменты, удалённые параметры, другая форма ответов.

Параметры
  • argsstring[]

    Дополнительные аргументы для команды.

  • cassettestringобязательный

    Путь к JSON-файлу кассеты.

  • commandstringобязательный

    Команда для запуска MCP-сервера.

watch

Проверяет сервер и показывает изменения с последней проверки. Выполняет все проверки, сохраняет результат и сравнивает с предыдущим запуском для той же цели. Показывает регрессии, восстановления и отклонения схемы за один вызов.

Параметры
  • argsstring[]

    Дополнительные аргументы для команды.

  • commandstringобязательный

    Команда для запуска MCP-сервера.

1.49.0основная
1.48.2
1.48.1
1.48.0
1.47.0
1.46.0
1.45.5
1.45.4
1.45.3
1.45.2
1.45.1
1.45.0
1.44.3
1.44.2
1.44.1
1.44.0
1.43.1
1.43.0
1.42.0
1.41.1
1.41.0
1.40.0
1.39.0
1.38.0
1.37.7
1.37.6
1.37.5
1.37.4
1.37.3
1.37.2
1.37.1
1.37.0
1.36.5
1.36.4
1.36.3
1.36.2
1.35.10
1.35.9
1.35.8
1.35.7
1.35.6
1.35.5
1.35.4
1.35.3
1.36.1
1.35.2
1.36.0
1.34.1
1.35.1
1.33.1
1.35.0
1.34.0
1.33.0
1.32.1
1.32.0
1.31.0
1.30.0
1.28.3
1.29.2
1.29.1
1.29.0
1.28.2
1.28.1
0.28.0
0.27.0
0.26.1
0.26.0
0.25.1
0.25.0
0.24.0
0.23.0
0.22.0
0.21.0
0.20.3
0.20.2
0.20.1
0.20.0
0.19.0
0.18.0
0.17.0
0.16.1
0.16.0
0.15.0
0.14.7
0.14.6
0.14.5
0.14.4
0.14.3
0.14.2
0.14.1
0.14.0
0.13.0
0.12.0
0.11.0
0.8.2
0.8.1
0.10.0
0.9.0
0.7.1
0.8.0
0.7.0
0.6.1
0.6.0
0.5.3
0.5.1
0.5.0
0.4.1
0.4.0
0.3.3
0.3.2
0.3.1
0.3.0

Выберите клиент, чтобы установить KryptosAI/mcp-observatory:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "kryptosai-mcp-observatory-u2ivpzczpr": {
      "args": [
        "-y",
        "@kryptosai/mcp-observatory",
        "serve"
      ],
      "command": "npx"
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "kryptosai-mcp-observatory-u2ivpzczpr": {
      "args": [
        "-y",
        "@kryptosai/mcp-observatory",
        "serve"
      ],
      "command": "npx"
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "kryptosai-mcp-observatory-u2ivpzczpr": {
      "type": "stdio",
      "args": [
        "-y",
        "@kryptosai/mcp-observatory",
        "serve"
      ],
      "command": "npx"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"kryptosai-mcp-observatory-u2ivpzczpr\",\"type\":\"stdio\",\"args\":[\"-y\",\"@kryptosai/mcp-observatory\",\"serve\"],\"command\":\"npx\"}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "kryptosai-mcp-observatory-u2ivpzczpr": {
      "args": [
        "-y",
        "@kryptosai/mcp-observatory",
        "serve"
      ],
      "command": "npx"
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add kryptosai-mcp-observatory-u2ivpzczpr -- npx -y @kryptosai/mcp-observatory serve

Либо через JSON-конфиг:

claude mcp add-json kryptosai-mcp-observatory-u2ivpzczpr "{\"args\":[\"-y\",\"@kryptosai/mcp-observatory\",\"serve\"],\"command\":\"npx\"}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add kryptosai-mcp-observatory-u2ivpzczpr -- npx -y @kryptosai/mcp-observatory serve

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.kryptosai-mcp-observatory-u2ivpzczpr]
command = "npx"
args = ["-y", "@kryptosai/mcp-observatory", "serve"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите KryptosAI/mcp-observatory, а в поле команды запуска — строку ниже:
npx -y @kryptosai/mcp-observatory serve

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "kryptosai-mcp-observatory-u2ivpzczpr": {
      "args": [
        "-y",
        "@kryptosai/mcp-observatory",
        "serve"
      ],
      "command": "npx"
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "kryptosai-mcp-observatory-u2ivpzczpr": {
      "args": [
        "-y",
        "@kryptosai/mcp-observatory",
        "serve"
      ],
      "command": "npx",
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например kryptosai-mcp-observatory-u2ivpzczpr.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: kryptosai-mcp-observatory-u2ivpzczpr
    command: npx
    args:
      - "-y"
      - "@kryptosai/mcp-observatory"
      - "serve"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "kryptosai-mcp-observatory-u2ivpzczpr": {
      "args": [
        "-y",
        "@kryptosai/mcp-observatory",
        "serve"
      ],
      "command": "npx"
    }
  }
}

Похожие MCP-сервера

Thezenmonster/agentscore-mcp-server

Thezenmonster/agentscore-mcp-server

от thezenmonster

MCP сервер для оценки безопасности пакетов: сканирует зависимости, выносит вердикты доверия, проверяет уязвимости и настраивает CI-политику. Восемь инструментов без API-ключа. Помогает разработчикам принимать решения о безопасности MCP.

TypeScript⭐ 1
vighriday/Veris

vighriday/Veris

от vighriday

Veris — инфраструктура верификации поведения для AI-агентов: строит граф зависимостей, выявляет риски, дрейф и семантические рабочие процессы без запуска тестов. Полезна разработчикам и CI-пайплайн...

TypeScript⭐ 1
gbrigandi/mcp-server-wazuh

gbrigandi/mcp-server-wazuh

от gbrigandi

MCP-сервер на Rust для интеграции Wazuh SIEM с AI-ассистентами. Позволяет запрашивать на естественном языке данные об алертах, уязвимостях и комплаенсе. Полезен командам безопасности для оперативно...

Rust⭐ 240
hyperb1iss/droidmind

hyperb1iss/droidmind

от hyperb1iss

DroidMind связывает AI-ассистентов с Android-устройствами через MCP. Управляйте приложениями, анализируйте логи, автоматизируйте UI и выполняйте shell-команды на естественном языке. Полезен разрабо...

Python⭐ 440
toan203/osv-ui

toan203/osv-ui

от toan203

MCP-сервер для безопасности зависимостей: сканирует npm, Python, Go и другие экосистемы на CVE. Интегрируется с AI-агентами, открывает визуальный дашборд с оценками риска и подсказками по исправлению. Работает локально, без регистрации.

HTML⭐ 4
Neverlow512/agent-droid-bridge

Neverlow512/agent-droid-bridge

от neverlow512

MCP-сервер для подключения AI-агентов к Android-устройствам через ADB. Используется в мобильной автоматизации, тестировании и реверс-инжиниринге: скриншоты, касания, ввод текста, управление приложе...

Python⭐ 22
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин