APISIX-MCP

El servidor APISIX Model Context Protocol (MCP) se utiliza para conectar modelos de lenguaje grandes (LLMs) con la API de administración de APISIX, permitiendo consultar y gestionar todos los recursos en Apache APISIX.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor Model Context Protocol (MCP) de APISIX

El servidor Model Context Protocol (MCP) de APISIX se utiliza para conectar modelos de lenguaje grandes (LLMs) con la API de administración de APISIX. Su objetivo es permitir la interacción basada en lenguaje natural para ver y gestionar recursos en APISIX a través de clientes de IA compatibles con MCP.

mcp-demo.mp4

Operaciones compatibles

Operaciones comunes

get_resource: Recuperar recursos por tipo (rutas, servicios, upstreams, etc.)
delete_resource: Eliminar recursos por ID
send_request_to_gateway: Enviar una solicitud o múltiples solicitudes al gateway de APISIX

Operaciones de recursos de API

create_route / update_route / delete_route: Gestionar rutas
create_service / update_service / delete_service: Gestionar servicios
create_upstream / update_upstream / delete_upstream: Gestionar upstream
create_ssl / update_ssl / delete_ssl: Gestionar certificados SSL
create_or_update_proto: Gestionar definiciones de protobuf
create_or_update_stream_route: Gestionar rutas de flujo

Operaciones de plugins

get_all_plugin_names: Obtener todos los nombres de plugins disponibles
get_plugin_info / get_plugins_by_type / get_plugin_schema: Recuperar configuración de plugins
create_plugin_config / update_plugin_config: Gestionar configuraciones de plugins
create_global_rule / update_global_rule: Gestionar reglas globales de plugins
get_plugin_metadata / create_or_update_plugin_metadata / delete_plugin_metadata: Gestionar metadatos de plugins

Configuración de seguridad

get_secret_by_id / create_secret / update_secret: Gestionar secretos
create_or_update_consumer / delete_consumer: Gestionar consumidores
get_credential / create_or_update_credential / delete_credential /: Gestionar credenciales de consumidores
create_consumer_group / delete_consumer_group: Gestionar grupos de consumidores

Configuración en el cliente de IA

Requisito previo

Siga la guía de APISIX Getting Started para configurar y ejecutar APISIX.

Instalación mediante Smithery

Para instalar automáticamente el Servidor Model Context Protocol de APISIX para Claude Desktop mediante Smithery:

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

Usando npm

Configure su cliente de IA (Cursor, Claude, Copilot, etc.) con la siguiente configuración:

{
  "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"
      }
    }
  }
}

Usando código fuente

Primero clone el repositorio apisix-mcp:

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

Instale las dependencias y compile el proyecto:

pnpm install
pnpm build

Configure su cliente de IA (Cursor, Claude, Copilot, etc.) con la siguiente configuración:

{
  "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"
      }
    }
  }
}

Variables de entorno

Variable	Descripción	Valor predeterminado
`APISIX_SERVER_HOST`	Host que tiene acceso a su servidor APISIX	`http://127.0.0.1`
`APISIX_SERVER_PORT`	Puerto del servidor APISIX	`9080`
`APISIX_ADMIN_API_PORT`	Puerto de la API de administración	`9180`
`APISIX_ADMIN_API_PREFIX`	Prefijo de la API de administración	`/apisix/admin`
`APISIX_ADMIN_KEY`	Clave de autenticación de la API de administración	`edd1c9f034335f136f87ad84b625c8f1`

Para ver o modificar las configuraciones de la API de administración en APISIX, consulte la documentación de Admin API.

Recursos

Soporte de API de Marketplace MCP Abierto

| GitHub | Doc | MCP Marketplace

Permitir que aplicaciones de IA/agentes/LLMs encuentren este servidor MCP mediante API comunes de python/typescript, busquen y exploren servidores y herramientas relevantes

Ejemplo: Buscar servidores y herramientas

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=[])