gRPC Invoke MCP

Herramienta de línea de comandos que te permite interactuar con servidores gRPC. Es básicamente curl para servidores gRPC

GitHub
1
Prueba este MCPPatrocinado

Documentación

gRPC Invoke MCP

npm version npm downloads license

grpc-invoke-mcp es un servidor MCP para invocar métodos gRPC desde agentes de IA como Claude Code, Codex, Cursor y otras herramientas compatibles con MCP.

Proporciona a los agentes una forma sencilla de inspeccionar APIs gRPC e invocar RPC unarios utilizando reflexión de servidor o archivos .proto locales. Esto es útil cuando quieres que un agente explore servicios, comprenda esquemas de solicitudes y respuestas, realice llamadas gRPC reales y pruebe integraciones gRPC durante el desarrollo impulsado por agentes, sin necesidad de escribir scripts desechables.

Características

  • Invoca métodos gRPC desde agentes compatibles con MCP
  • Describe servicios, métodos y tipos de mensajes gRPC
  • Utiliza reflexión de servidor o archivos .proto locales
  • Conéctate a través de TLS o HTTP/2 en texto plano
  • Envía cabeceras de metadatos personalizadas
  • Pasa cuerpos de solicitud JSON para RPC unarios
  • Funciona con Claude Code, Codex, Cursor y otros clientes MCP

Instalación

Ejecuta el servidor con npx:

npx -y @grulex/grpc-invoke-mcp@latest

El paquete descarga un binario grpc-invoke-mcp específico de la plataforma durante la instalación.

Configuración del Agente

Claude Code

Archivo de configuración del proyecto: .mcp.json

{
  "mcpServers": {
    "grpc-invoke": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@grulex/grpc-invoke-mcp@latest"]
    }
  }
}

Configuración CLI opcional:

claude mcp add --transport stdio grpc-invoke -- npx -y @grulex/grpc-invoke-mcp@latest

Codex

Archivo de configuración del usuario: ~/.codex/config.toml

[mcp_servers.grpc-invoke]
command = "npx"
args = ["-y", "@grulex/grpc-invoke-mcp@latest"]

Configuración CLI opcional:

codex mcp add grpc-invoke -- npx -y @grulex/grpc-invoke-mcp@latest

Cursor

Archivo de configuración del proyecto: .cursor/mcp.json

{
  "mcpServers": {
    "grpc-invoke": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@grulex/grpc-invoke-mcp@latest"]
    }
  }
}

También puedes instalarlo globalmente en ~/.cursor/mcp.json.

Herramientas Disponibles

grpc_describe

Usa esta herramienta para inspeccionar servicios, métodos y tipos de mensajes.

Casos de uso comunes:

  • Listar servicios expuestos por un servidor gRPC
  • Inspeccionar la firma de un método antes de invocarlo
  • Explorar esquemas de mensajes mediante reflexión
  • Describir APIs desde archivos .proto locales

grpc_call

Usa esta herramienta para invocar métodos gRPC unarios con un cuerpo de solicitud JSON.

Casos de uso comunes:

  • Llamar microservicios internos desde tu agente
  • Probar cargas útiles de solicitud y respuesta
  • Enviar cabeceras de autenticación u otros metadatos gRPC
  • Conectarte a endpoints locales, de staging o seguros para producción

Ejemplos de Prompts

  • "Describe los servicios expuestos por localhost:50051 usando reflexión."
  • "Muestra el esquema de solicitud para helloworld.Greeter/SayHello."
  • "Llama a helloworld.Greeter/SayHello en localhost:50051 con { \"name\": \"World\" }."
  • "Invoca package.Service/Method usando proto_files y import_paths en lugar de reflexión."

Cómo Funciona

Este paquete expone un servidor MCP a través de stdio. Tu agente lo inicia localmente y descubre herramientas como:

  • grpc_describe para inspección de esquemas
  • grpc_call para invocación de RPC unarios

Internamente, el paquete npm lanza un binario nativo grpc-invoke-mcp incluido en el momento de la instalación. El binario admite:

  • Reflexión de servidor gRPC
  • Definiciones .proto locales
  • Conexiones en texto plano o TLS
  • Cabeceras de metadatos de solicitud

Plataformas Soportadas

El instalador actualmente está dirigido a:

  • macOS Apple Silicon
  • macOS Intel
  • Linux x64
  • Linux ARM64
  • Windows x64
  • Windows ARM64

Solución de Problemas

npx no puede iniciar el servidor

Asegúrate de que Node.js y npx estén instalados y disponibles en tu PATH.

La descarga del binario falla

El paquete npm descarga un artefacto de lanzamiento durante la instalación, por lo que tu máquina necesita acceso de red a GitHub Releases.

La reflexión no funciona

Si el servidor de destino no expone reflexión gRPC, usa archivos .proto locales y import_paths en su lugar.

Errores de TLS o conexión

Verifica el host de destino, el puerto, la configuración TLS y si el servidor espera texto plano o TLS.

El agente no usa el servidor MCP

Confirma que el archivo de configuración esté en la ubicación correcta para tu cliente, reinicia el cliente si es necesario y verifica que el servidor aparezca en la lista MCP o en el panel de herramientas.

Por Qué Usar grpc-invoke-mcp

Si trabajas con servicios gRPC, este servidor MCP permite que los agentes de IA inspeccionen y llamen a esos servicios directamente. En lugar de traducir los detalles de la API manualmente, puedes dejar que Claude Code, Codex, Cursor u otros agentes compatibles con MCP exploren el contrato y ejecuten solicitudes seguras y específicas para depuración, trabajo de integración, descubrimiento de APIs y pruebas gRPC en flujos de trabajo de desarrollo impulsados por agentes.

Licencia

MIT