ApiFox MCP Server

ApiFox MCP サーバー

これは Model Context Protocol（MCP）に基づく ApiFox インターフェースサーバーで、ApiFox のインターフェース情報を取得・管理します。Cursor で MCP サービスを設定すると、該当するインターフェースモジュールの情報を取得して LLM に返し、Cursor がインターフェース情報を使ってビジネスロジックの実装を支援します。

特長

• MCP プロトコルを通じて ApiFox のインターフェース情報を取得できます
• HTTP サービスと CLI コマンドラインの 2 つの利用方法を提供します
• TypeScript で開発されており、型安全性を備えています
• 環境変数による設定に対応しています

クイックインストールと使い方

npx @wangmhaha/apifox-mcp-server@latest --apifox-api-key=<your-apifox-api-key> --project=<your-project-id>

Cursor を設定して SSE 経由で MCP サーバーに接続する

サーバーは設定したポートで起動します（デフォルトは 3000 です）。

"apifox-mcp-server": {
    "url": "http://localhost:3000/sse",
  }

JSON 設定ファイルの使用を推奨します

Cursor の MCP 設定ファイルに以下の内容を追加して、apifox-mcp-server サーバーを設定できます。

 "apifox-mcp-server": {
    "command": "npx",
    "args": ["-y", "@wangmhaha/apifox-mcp-server@latest", "--local"],
    "env": {
      "APIFOX_API_KEY": "<your-apifox-api-key>",
      "PROJECT_ID": "<your-project-id>"
    }
  }

またはローカルソースから実行する

コードを取得して依存関係をインストールします。

pnpm install

ビルド

pnpm build

実行

pnpm start:http

設定：

"apifox-mcp-server": {
    "url": "http://localhost:3000/sse",
    "env": {
      "APIFOX_API_KEY": "<your-apifox-api-key>",
      "PROJECT_ID": "<your-project-id>"
    }
  }

command モードで実行することもできます。

"apifox-mcp-server": {
    "command": "node",
    "args": [
      "<you-local-path>/build/index.js",
      "--local",
    ],
    "env": {
      "APIFOX_API_KEY": "<your-apifox-api-key>",
      "PROJECT_ID": "<your-project-id>"
    }
  },

MCP 設定ファイルで env 環境変数を設定しない場合は、ローカル環境変数を設定してください

プロジェクトのルートディレクトリで、.evn.example ファイルを .env ファイルに変更し、以下の環境変数を設定します。

APIFOX_API_KEY=your_api_key_here
PROJECT_ID=your_project-ID
PORT=3000  # 可选，默认为 3000

技術スタック

• Node.js
• TypeScript
• Express.js
• Model Context Protocol SDK
• Zod（データ検証）

ライセンス

ISC ライセンス