APISIX-MCP

Translates natural language queries from LLMs into APISIX Admin API calls to retrieve resource state (routes, services, upstreams, consumers, plugins). Uses MCP protocol to expose APISIX resources as queryable tools, enabling LLMs to introspect gateway configuration without direct API knowledge. Implements request translation layer that converts LLM tool calls into properly formatted HTTP requests to APISIX Admin API endpoints.

Enables LLMs to create, update, and delete APISIX resources (routes, services, upstreams, consumers, plugins) through MCP tool calls that translate to APISIX Admin API mutations. Implements validation and schema enforcement to ensure LLM-generated configurations conform to APISIX resource specifications before submission. Handles request body construction, HTTP method routing (POST/PUT/DELETE), and response parsing.

Exposes APISIX monitoring metrics and status information through MCP tools, enabling LLMs to query gateway health, request statistics, and plugin performance metrics. Implements metrics aggregation and formatting for LLM consumption. Supports querying metrics from APISIX metrics endpoint or integrated monitoring systems.

Implements MCP server that exposes APISIX Admin API as a set of standardized MCP tools and resources. Handles MCP protocol handshake, tool schema definition, request/response serialization, and error propagation. Maps APISIX API endpoints to MCP tool definitions with proper input validation schemas, enabling any MCP-compatible client (Claude, custom agents) to interact with APISIX without protocol translation logic.

Validates LLM-generated resource configurations against APISIX schema before submission to Admin API. Implements input validation for required fields, type checking, and constraint enforcement (e.g., valid HTTP methods, port ranges). Catches and translates APISIX API errors into human-readable messages for LLM context, enabling error recovery and retry logic.

Coordinates creation and modification of dependent APISIX resources (e.g., creating upstream, then service, then route) through sequenced MCP tool calls. Manages resource dependencies and ordering constraints, enabling LLMs to express complex gateway configurations as high-level intents. Handles partial failures and provides rollback or cleanup guidance when multi-step operations fail.

Exposes APISIX plugin ecosystem through MCP tools, enabling LLMs to discover available plugins, configure plugin parameters, and attach plugins to routes/services. Implements plugin schema validation and parameter type checking. Handles plugin-specific configuration complexity (e.g., authentication plugins, rate limiting, request transformation) through structured tool definitions.

Manages APISIX consumer resources and authentication credentials (API keys, OAuth, basic auth) through MCP tools. Enables LLMs to create consumers, generate credentials, and configure authentication plugins. Implements secure credential handling and validation of authentication configuration against APISIX requirements.

Exposes APISIX upstream resources and load balancing configuration through MCP tools. Enables LLMs to create upstreams with multiple backend targets, configure load balancing algorithms (round-robin, least connections, consistent hash), and manage health checks. Implements validation of upstream configuration and health check parameters.

Manages APISIX service and route resources through MCP tools, enabling LLMs to create routes with path matching, HTTP method filtering, and upstream binding. Implements route priority handling, path pattern validation, and service-to-route relationship management. Supports advanced routing features like regex patterns, host matching, and request header conditions.

Enables exporting APISIX gateway configuration (routes, services, upstreams, plugins, consumers) as structured data through MCP tools, and importing configurations from external sources. Implements configuration serialization to JSON/YAML formats suitable for version control and backup. Handles configuration validation during import to ensure consistency.