Openapi Inspector

none.api - OpenAPI エクスプローラー MCP サーバー

フロントエンド開発とバックエンドのコントラクト検証に最適化された、Model Context Protocol（MCP）向けのプロフェッショナルな OpenAPI エクスプローラーです。

これは何ですか？

この MCP サーバーを使うと、Claude や Cursor などの大規模言語モデル（LLM）が、OpenAPI／Swagger 仕様を持つあらゆる API を動的に探索し、理解して、操作できます。

特に、次の用途向けに設計されています。

1. フロントエンド開発の加速：API 定義から型、Zod スキーマ、モックデータ、データ取得用フック（Axios／TanStack Query）を直接生成します。
2. バックエンド実装の検証：バックエンドのレスポンスオブジェクトを OpenAPI コントラクトと照合し、実装が仕様に一致していることを確認します。

インストール

npx を使用（推奨）

インストールせずにサーバーを直接実行できます。

npx @nonetss/none.api

グローバルインストール

npm install -g @nonetss/none.api

主な機能

• スマートな探索：エンドポイントをカテゴリ別に一覧表示し、キーワード検索できます（多言語の同義語に対応）。
• フロントエンドファクトリー：
  • リクエストとレスポンス用の TypeScript インターフェースを生成します。
  • フォーム検証用の Zod スキーマを生成します。
  • React／Axios／TanStack Query のコードスニペットを生成します。
  • UI プロトタイピング用の モックデータを生成します。
• バックエンドガード：
  • レスポンス検証：AJV を使用して、JSON データを OpenAPI スキーマと照合します。
  • 依存関係のマッピング：リソース間の関連性（たとえば、別のエンドポイントで必要な ID をどのエンドポイントが提供するか）を把握できます。
• セキュリティ：認証（Bearer／API Key）に自動対応し、環境変数に固定された安全な設定を使用します。

ツールの概要

ツール	用途	説明
list_endpoints	探索	すべてのエンドポイントを機能カテゴリ別に一覧表示します。
list_tags	探索	API 内のすべてのタグ（機能カテゴリ）を一覧表示します。
search_by_tag	探索	特定のタグに関連付けられたすべてのエンドポイントを一覧表示します。
find_endpoint	探索	意図またはキーワード（例：「ユーザーを削除」）で検索します。
get_endpoint_info	分析	詳細なドキュメント、パラメーター、レスポンスコードを表示します。
get_request_schema	分析	エンドポイントのリクエストボディの JSON スキーマを返します。
get_response_schema	分析	指定したレスポンスステータスコードの JSON スキーマを返します。
get_typescript_types	フロントエンド	すぐに使える TypeScript インターフェースを生成します。
get_zod_schema	フロントエンド	Zod 検証スキーマを生成します。
get_framework_snippet	フロントエンド	Axios または TanStack Query のコードを生成します。
get_fetch_snippet	フロントエンド	手軽に統合できるネイティブ fetch のコードスニペットを生成します。
get_mock_data	プロトタイピング	スキーマに基づいた高精度なモックデータを生成します。
map_dependencies	アーキテクチャ	ルート間のデータフローと ID の関連性を分析します。
get_security_info	セキュリティ	API または特定のルートに必要なセキュリティ要件を表示します。
set_security_context	セキュリティ	以降のリクエスト用に認証ヘッダーを設定します。
call_endpoint	デバッグ	設定済みの API に実際の HTTP リクエストを実行します。
validate_response	バックエンド	JSON オブジェクトを API コントラクトと照合して検証します。

設定

claude_desktop_config.json または Cursor の MCP 設定に次の内容を追加します。

{
  "mcpServers": {
    "none.api": {
      "command": "npx",
      "args": ["-y", "@nonetss/none.api"],
      "env": {
        "OPENAPI_URL": "http://localhost:3000/doc",
        "AUTH_EMAIL": "[email protected]",
        "AUTH_PASSWORD": "your-password",
        "AUTH_PATH": "/api/auth/login"
      }
    }
  }
}

開発ワークフロー

1. ビルド：npm run build（パス解決に tsc と tsc-alias を使用します）。
2. フォーマット：Prettier が含まれています。
3. Git フック：husky と lint-staged によって、コミット時にフォーマットが自動実行されます。