MCP-Skills機能ガイド

なぜEchoAPIを作ったのか？Postmanのような従来の手動APIツールを作るのではなく、AIでCursor、Codex、Claude Code、TraceなどのAIコードエディタの「最高のパートナー」にすることを目指しました。

通常、ソフトウェア開発には「二つの手」が必要です。一方の手はコードエディタを使い（コードを書きAPIを作成）、もう一方の手はAPIツールを使い（それらのAPIをテスト）。これまで、この二つのツールは完全に分離しており、互いに連携していませんでした。

しかし今、AI-MCP-Skills技術のおかげで、自動的に接続して協働動作させることが可能です。主に二つのことができます：

コード自動スキャンでAPI作成: エディタのコードをAIが解析し、APIリストを作成します。このリストはMCPを使用してEchoAPIに自動保存され、簡単にテストや管理が可能です。
APIからコード自動生成: 既存のAPIリストをMCPを使用してコードエディタに送信することもできます。AIが実際のAPIに基づいてコードを生成し、推測やエラーを防ぎます。

I. MCP-Skillsの接続方法

1.1 EchoAPIのmcp-jsonファイルを作成

まず、設定ファイルを作成します。以下のJSON構造をコピーしてください：

mcp.json

{
  "mcpServers": {
    "echoapi-mcp": {
      "url": "https://open.echoapi.com/mcp",
      "headers": {
        "api-token": "Paste your EchoAPI Token"
      }
    }
  }
}

注意: api-token はEchoAPIの Advanced → OpenAPI → Create で取得できます。以下の写真のようにトークンを保存してコピーしてください：

1.2 接続をセットアップ（Cursorの例）

Cursorの設定で[Tools & MCPs]を開き、[Add custom MCP]をクリックして新しい接続を作成します。

次に、ステップ1.1の mcp.json コードをコピーし、Cursorに貼り付けます。

II. コードを自動スキャンしてAPIリストを生成しEchoAPIに同期

従来の「先に開発、後にドキュメント」ワークフローを変革します。メインストリームのAIプログラミングツールで自然言語コマンドを使用し、LLMがビジネスコード構造を自動スキャンし、インターフェースパス、リクエストパラメータ、レスポンス形式を正確に解析します。

シームレス同期: EchoAPIの書き込み機能を自動呼び出し、コード構造を標準APIアセットに変換します。
すぐに使用可能: 生成されたインターフェースにはリクエストURLと標準化された命名が付き、チームメンバーがすぐに表示・デバッグできます。
遅延の排除: APIドキュメントが最新のコードと100%一致することを保証します。

III. EchoAPIからAPIリストを取得してコードを生成

既存のプロジェクトや進行中のプロジェクトでは、AIがEchoAPIリストを読み込み、厳格なルールブックとして使用します。これにより、AIはより正確なコードを書けます。

正確なコード: 実際のインターフェース仕様に基づき、パラメータ検証付きのフロントエンド/バックエンド呼び出しレイヤーコードを自動生成します。
包括的テスト: 既存のAPI定義に基づき、様々な境界条件をカバーするユニットテストケースを大量に自動生成します。
フルスタック対応: Java、Python、Node.js、PHP、Goなどの人気プログラミング言語をサポートし、既存のプロジェクトにスムーズに統合できます。

対応言語

JavaPythonNode.jsPHPGoTypeScript

I. MCP-Skillsの接続方法

1.1 EchoAPIのmcp-jsonファイルを作成

1.2 接続をセットアップ（Cursorの例）

II. コードを自動スキャンしてAPIリストを生成しEchoAPIに同期

III. EchoAPIからAPIリストを取得してコードを生成

対応エディタ