APISIX Mcp

APISIX Model Context Protocol（MCP）サーバー

APISIX Model Context Protocol（MCP）サーバーは、LLM と APISIX Admin API を接続するために使用されます。MCP 互換の AI クライアントを通じて、自然言語で APISIX のリソースを表示・管理できるようにすることを目的としています。

https://github.com/user-attachments/assets/081e878c-225e-4ff8-a9c5-5813f4784cfe

対応操作

一般的な操作

• get_resource：タイプ（routes、services、upstreams など）ごとにリソースを取得します
• delete_resource：ID でリソースを削除します
• send_request_to_gateway：APISIX ゲートウェイに 1 つまたは複数のリクエストを送信します

API リソースの操作

• create_route/update_route/delete_route：ルートを管理します
• create_service/update_service/delete_service：サービスを管理します
• create_upstream/update_upstream/delete_upstream：アップストリームを管理します
• create_ssl/update_ssl/delete_ssl：SSL 証明書を管理します
• create_or_update_proto：protobuf 定義を管理します
• create_or_update_stream_route：ストリームルートを管理します

プラグインの操作

• get_all_plugin_names：利用可能なすべてのプラグイン名を取得します
• get_plugin_info/get_plugins_by_type/get_plugin_schema：プラグインの設定を取得します
• create_plugin_config/update_plugin_config：プラグインの設定を管理します
• create_global_rule/update_global_rule：プラグインのグローバルルールを管理します
• get_plugin_metadata/create_or_update_plugin_metadata/delete_plugin_metadata：プラグインのメタデータを管理します

セキュリティ設定

• get_secret_by_id/create_secret/update_secret：シークレットを管理します
• create_or_update_consumer/delete_consumer：コンシューマーを管理します
• get_credential/create_or_update_credential/delete_credential/：コンシューマーの認証情報を管理します
• create_consumer_group/delete_consumer_group：コンシューマーグループを管理します

AI クライアントでの設定

前提条件

APISIX をセットアップして実行するには、APISIX のはじめにガイドに従ってください。

Smithery 経由でインストールする

Smithery 経由で Claude Desktop 用の APISIX Model Context Protocol Server を自動インストールするには、次のようにします。

npx -y @smithery/cli install @api7/apisix-mcp --client claude

npm を使用する

AI クライアント（Cursor、Claude、Copilot など）を次の設定で構成します。

{
  "mcpServers": {
    "apisix-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "apisix-mcp"
      ],
      "env": {
        "APISIX_SERVER_HOST": "your-apisix-server-host",
        "APISIX_SERVER_PORT": "your-apisix-server-port",
        "APISIX_ADMIN_API_PORT": "your-apisix-admin-api-port",
        "APISIX_ADMIN_API_PREFIX": "your-apisix-admin-api-prefix",
        "APISIX_ADMIN_KEY": "your-apisix-api-key"
      }
    }
  }
}

ソースコードを使用する

まず、apisix-mcp リポジトリをクローンします。

git clone https://github.com/api7/apisix-mcp.git
cd apisix-mcp

依存関係をインストールし、プロジェクトをビルドします。

pnpm install
pnpm build

AI クライアント（Cursor、Claude、Copilot など）を次の設定で構成します。

{
  "mcpServers": {
    "apisix-mcp": {
      "command": "node",
      "args": [
        "your-apisix-mcp-path/dist/index.js"
      ],
      "env": {
        "APISIX_SERVER_HOST": "your-apisix-server-host",
        "APISIX_SERVER_PORT": "your-apisix-server-port",
        "APISIX_ADMIN_API_PORT": "your-apisix-admin-api-port",
        "APISIX_ADMIN_API_PREFIX": "your-apisix-admin-api-prefix",
        "APISIX_ADMIN_KEY": "your-apisix-api-key"
      }
    }
  }
}

環境変数

変数	説明	デフォルト値
APISIX_SERVER_HOST	APISIX サーバーにアクセスできるホスト	http://127.0.0.1
APISIX_SERVER_PORT	APISIX サーバーのポート	9080
APISIX_ADMIN_API_PORT	Admin API のポート	9180
APISIX_ADMIN_API_PREFIX	Admin API のプレフィックス	/apisix/admin
APISIX_ADMIN_KEY	Admin API の認証キー	edd1c9f034335f136f87ad84b625c8f1

APISIX の Admin API 設定を表示または変更するには、Admin API のドキュメントを参照してください。

リソース

オープン MCP マーケットプレイス API に対応

|GitHub|ドキュメント|MCP マーケットプレイス

• AI アプリ／エージェント／LLM が、共通の Python／TypeScript API を通じてこの MCP サーバーを見つけ、関連するサーバーやツールを検索・探索できるようにします

例：サーバーとツールの検索

    import anthropic
    import mcp_marketplace as mcpm

    result_q = mcpm.search(query="apisix mcp", mode="list", page_id=0, count_per_page=100, config_name="deepnlp") # search server by category choose various endpoint
    result_id = mcpm.search(id="api7/apisix-mcp", mode="list", page_id=0, count_per_page=100, config_name="deepnlp")      # search server by id choose various endpoint 
    tools = mcpm.list_tools(id="api7/apisix-mcp", config_name="deepnlp_tool")

    # Call Claude to Choose Tools Function Calls 
    client = anthropic.Anthropic()
    response = client.messages.create(model="claude-3-7-sonnet-20250219", max_tokens=1024, tools=tools, messages=[])