API Debugger MCP

FastMCPを使用してHTTP APIを検査、テスト、検証、比較、デバッグするための、本番向けのModel Context Protocol (MCP) サーバーです。

このプロジェクトの背景

APIの不具対対応では、APIクライアント、従来のドキュメント、ログ、テスト、スイート、バグトラッカー技術を頻繁に行き来きする必要があります。APIDebugger MCP は、MCP互換のAIエージェントに対し、これらの調査を実行するための構造化されたツールキットを提供します。

##馬能

• APIデバッグと QAのための12のMCPツール

• 一般的な資格情報フィールドとヘッダーの安全なシークレットマスキング

• 設定可能なタイムアウトとレスポンスサイズの上限

• プライベート/ローカルネットワアクセスをデフォルトでブロック

• JSONスキーマ形式のレスポンス契約の検証

• レスポンスボディ間のリグレッション比較

• 複数エンドポイントのヘルスチェック

• APIテススチケナリオの自動生成

• 構造化されたバグレポートの生成

• エンドツーエンドのインシデント調査ワークフロー

• MCPリソースと再利用可能なプロンプト

• Dockerサポート

• Pytest + coverage

• Ruff linting

• Python 3.10–3.12でのGitHub Actions CI

Related MCP server: agent-validator-mcp-server

MCPツール

1. inspect_endpoint

2. send_request

3. validate_response

4. compare_responses

5. analyze_error

6. detect_api_issue

7. generate_api_tests

8. generate_bug_report

9. check_contract

10. api_health_check

11. redact_sensitive_data

12. investigate_incident

プロジェクト構成

api-debugger-mcp/
├── .github/workflows/ci.yml
├── docs/
├── src/api_debugger_mcp/
│   ├── analysis.py
│   ├── client.py
│   ├── config.py
│   ├── models.py
│   ├── security.py
│   ├── server.py
│   └── tools.py
├── tests/
├── .dockerignore
├── .env.example
├── .gitignore
├── Dockerfile
├── LICENSE
├── Makefile
├── docker-compose.yml
└── pyproject.toml

クイックスタート

1. 仮想環境を作成する

python -m venv .venv

Windows:

.venv\Scripts\activate

macOS/Linux:

source .venv/bin/activate

2. インストール

pip install -e ".[dev]"

3. 設定

.env.example を .env にコピーし、使用する環境に必要な値だけを設定してください。

実際のAPIキーやベアラートークンをコミットしないでください。

4. ローカルで実行する

HTTP MCPサーバーの場合:

api-debugger-mcp

デフォルトのMCPエンドポイントは次のとおりです:

http://localhost:8000/mcp

ローカルのstdioモードの場合は:

MCP_TRANSPORT=stdio

その後、実行します:

api-debugger-mcp

Docker

docker compose up --build

サーバーはポート 8000 で公開されます。

テスト

pytest

Lint:

ruff check .

フォーマット:

ruff format .

MCPワークフローの例

MCP互換のエージェントは、次のようにツールを組み合わせて使用できます:

investigate_incident
    ↓
inspect_endpoint
    ↓
send_request
    ↓
detect_api_issue
    ↓
analyze_error
    ↓
check_contract
    ↓
generate_bug_report

リグレッションテストの場合:

send_request (baseline)
        ↓
send_request (current)
        ↓
compare_responses
        ↓
validate_response

セキュリティに関する注意事項

このサーバーは、デフォルトで認証情報の偶発的な漏えいや安全でないネットワークアクセスを防ぐように設計されています。

• 一般的な認証/クッキー/APIキーのヘッダーは、戻り値からマスキングされます。

• 一般的なシークレットフィールドは、再帰的にマスキングされます。

• ローカル/プライベートIPアドレスへのリクエストは、デフォルトで無効ですか?

• 実認証情報を含む .env はコミットしないでください。

• 本番環境では、MCPサーバーを組織の認証およびネットワーク管理の後ろに配置してください。

• 機余性の高い環境では、上私有者のネットワークへのアクセスを有効にする前に、明示的な許可リストを追加してしてください。

本番運用に向けたロードマップ

• OpenAPI 3.xのインポート・エンドポイント発見

• OAuth/APIキーのシークレットプロバイダー

• 永続的リグレッションのベースライン

• Sentry/観測性の連携

• Jira/GitHub is−の作間

• リクースの相関ID

• レート制限

• 監查ログ

• RBAC/認証

• 非同期の並行Hチェック

• 長時間の調査のためのMCPタスク/バックグランド実行

ライセンス

MIT