Repolode
KryptosAI

KryptosAI/mcp-observatory

MCPサーバー向けのオープンソースCI対応セキュリティ・回帰テストCLI。スキーマ差分、安全な攻撃シミュレーション、SARIF出力に対応します。

スター
120
フォーク
15
未解決の Issue
20
最終コミット
3 日前

これは何?

MCP Observatoryは、AIエージェントが依存する前にModel Context Protocol(MCP)サーバーをテストするためのコマンドラインツールです。サーバーに接続し、ツール、プロンプト、リソースをチェックします。必要に応じて安全な読み取り専用ツールを呼び出して正常に動作することを確認し、0〜100のヘルススコアと評価を付けます。

このツールは、CIに組み込みやすい回帰テストとセキュリティチェックに重点を置いています。サーバーとのセッションをcassetteファイルに記録してオフラインで再生したり、稼働中のサーバーを記録と照合したり、2回の実行結果を比較して追加・削除されたフィールドや、互換性を損なうパラメーター変更を検出したりできます。また、シェルインジェクションにつながる箇所、広範なファイルシステムアクセス、認証情報の漏えいなど、リスクのあるパターンがないかツールのスキーマを分析します。

結果はGitHub Code Scanning向けにSARIF形式で出力でき、setup-ciコマンドを使えばGitHub ActionsまたはGitLab CIのワークフローを生成できます。また、MCPサーバーとしても動作するため、エージェントから他のサーバーに対するチェックを呼び出せます。利用にはNode.js 20以降が必要で、npx、Homebrew、Dockerから利用できます。

主な機能

  • 01MCPサーバーのツール、プロンプト、リソースをチェックし、0〜100のヘルススコアを報告します。
  • 022回の実行結果を比較し、追加・削除された変更や互換性を損なう変更を検出して、スキーマの差分を把握します。
  • 03セッションをcassetteに記録し、オフラインで再生または検証できます。
  • 04安全な攻撃シミュレーションを実行し、リスクのあるツールスキーマのパターンを検出します。
  • 05検出結果をSARIF形式で出力し、GitHub ActionsまたはGitLab CIのワークフローを生成します。
  • 06MCPサーバーとして動作し、エージェントから他のMCPサーバーをテストできます。

ユースケース

  • 独自のMCPサーバーのCIパイプラインに、セキュリティと互換性のチェックを追加する。
  • サーバーに依存するエージェントに影響が出る前に、予期しないツールスキーマの変更を検出する。
  • サードパーティ製MCPサーバーをインストールする前に、リスクのあるツールパターンがないか確認する。
  • プルリクエストでMCPの検出結果をGitHub Code Scanningにアップロードする。

クイックスタート

  1. 1

    npx で最初のスキャンを実行する

    npx -y @kryptosai/mcp-observatory@latest
  2. 2

    特定の MCP サーバーをテストする

    npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything
  3. 3

    ローカルダッシュボードを開いて結果を確認する

    npx -y @kryptosai/mcp-observatory@latest dashboard

使う前に知っておきたいこと

  • Node.js 20 以降が必要です。
  • ClearFrame ワークフローなどの一部の高度な機能は、Apple Silicon のみをサポートする Mac アプリに依存しています。

収録されている特集

トピック

よくある質問

mcp-observatory とは?
MCPサーバー向けのオープンソースCI対応セキュリティ・回帰テストCLI。スキーマ差分、安全な攻撃シミュレーション、SARIF出力に対応します。 MCP Observatoryは、AIエージェントが依存する前にModel Context Protocol(MCP)サーバーをテストするためのコマンドラインツールです。サーバーに接続し、ツール、プロンプト、リソースをチェックします。必要に応じて安全な読み取り専用ツールを呼び出して正常に動作することを確認し、0〜100のヘルススコアと評価を付けます。
mcp-observatory は無料で使えますか?ライセンスは?
mcp-observatory は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
mcp-observatory は今もメンテナンスされていますか?
活発にメンテナンス中。mcp-observatory の最終コミットは 2026年11月4日 です。
mcp-observatory は何に使えますか?
独自のMCPサーバーのCIパイプラインに、セキュリティと互換性のチェックを追加する。 サーバーに依存するエージェントに影響が出る前に、予期しないツールスキーマの変更を検出する。 サードパーティ製MCPサーバーをインストールする前に、リスクのあるツールパターンがないか確認する。 プルリクエストでMCPの検出結果をGitHub Code Scanningにアップロードする。
mcp-observatory のインストール方法は?
npx で最初のスキャンを実行する: npx -y @kryptosai/mcp-observatory@latest 特定の MCP サーバーをテストする: npx -y @kryptosai/mcp-observatory@latest test npx -y @modelcontextprotocol/server-everything ローカルダッシュボードを開いて結果を確認する: npx -y @kryptosai/mcp-observatory@latest dashboard
mcp-observatory はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/KryptosAI/mcp-observatory

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト

人が承認したベースラインと照合しながら、記録済みのAPI呼び出しチェーンをバックエンドに再送してリリース間の変更を検出する回帰テスト用ハーネス。

開発ツール#testing#api-testing#regression-testing
2388+218 今週164GoMIT更新 12 日前