Características

🤖 Conéctate a cualquier cliente MCP ( Claude , Cursor , Windsurf , etc.)
🤖 Ejecute el servidor MCP localmente en su máquina con un comando
🤖 Conéctate a tus instancias de EventCatalog
🤖 Haz preguntas sobre tus arquitecturas
🤖 Haz preguntas sobre tus especificaciones OpenAPI y AsyncAPI
🤖 Pregunta por dominios, servicios y mensajes, y mucho más
🤖 Obtenga los esquemas para eventos, consultas, comandos y servicios (OpenAPI, AsyncAPI, esquema JSON)

Uso de IA para obtener más valor de EventCatalog

EventCatalog es una herramienta de código abierto que te ayuda a documentar tu arquitectura basada en eventos. Con EventCatalog puedes documentar tus dominios, servicios, mensajes, esquemas y mucho más.

EventCatalog visualizará su arquitectura para todos ustedes, brindará la posibilidad de agregar significado semántico para las partes interesadas, alojará sus especificaciones OpenPAI y AsyncAPI y se integrará con cualquier corredor del mundo.

Al utilizar el servidor MCP de EventCatalog, puede obtener más valor de su EventCatalog al hacer preguntas sobre su arquitectura en las herramientas que ya utiliza.

Los desarrolladores pueden integrar el servidor MCP con IDES compatibles con MCP (por ejemplo, Cursor , Windsurf ).
Las partes interesadas pueden hacer preguntas sobre su arquitectura en las herramientas que utilizan (por ejemplo, Claude )
Si está utilizando herramientas que no admiten el protocolo MCP, aún puede usar el estándar llms.txt para integrarse con otras herramientas LLLM (por ejemplo, Gemini , GPT-4 ).

Empezando

Instalación

Primero, debe habilitar la función LLMS.txt en su instancia de EventCatalog.

Habilite la función LLMS.txt en su instancia de EventCatalog, configurando su archivo eventcatalog.config.js .
Implemente su instancia de EventCatalog con la función LLMS.txt habilitada.

Instalación mediante herrería

Para instalar EventCatalog para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @event-catalog/mcp-server --client claude

Configurar clientes MCP

Cada cliente MCP tiene una forma diferente de agregar el servidor MCP.

A continuación encontrará algunos enlaces útiles para comenzar.

Escritorio de Claude
Cursor

Agregar el servidor MCP a Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su archivo claud_desktop_config.json . La ruta completa en macOS es: ~/Library/Application Support/Claude/claud_desktop_config.json ; en Windows: %APPDATA%\Claude\claud_desktop_config.json

{
  "mcpServers": {
    "eventcatalog": {
      "command": "npx",
      "args": [
        "-y",
        "@eventcatalog/mcp-server",
        "https://demo.eventcatalog.dev" // Replace with your EventCatalog URL
      ]
    }
  }
}

Agregar el servidor MCP a Cursor

Vaya a Configuración del cursor -> Servidores MCP -> Agregar servidor MCP.

Nombre: eventcatalog
Comando: npx
Argumentos: -y @eventcatalog/mcp-server {URL_TO_YOUR_EVENTCATALOG_INSTANCE}

Configuración para su proyecto

También puede crear archivos .mcp.json en su proyecto para configurar el servidor MCP para su proyecto usando Cursor.

{
  "mcpServers": {
    "eventcatalog": {
      "command": "npx",
      "args": ["-y", "@eventcatalog/mcp-server", "https://demo.eventcatalog.dev"]
    }
  }
}

Puede leer más sobre la configuración de su proyecto en la documentación de Cursor .

API

Aquí hay una lista de todas las API que admite el servidor MCP.

Recursos

eventcatalog://all
- Devuelve todos los mensajes, dominios y servicios del catálogo.
eventcatalog://domains
- Devuelve todos los dominios del catálogo.
eventcatalog://services
- Devuelve todos los servicios del catálogo.
eventcatalog://events
- Devuelve todos los eventos del catálogo.
eventcatalog://queries
- Devuelve todas las consultas del catálogo.
eventcatalog://commands
- Devuelve todos los comandos del catálogo.
eventcatalog://flows
- Devuelve todos los flujos del catálogo.
eventcatalog://teams
- Devuelve todos los equipos del catálogo.
eventcatalog://users
- Devuelve todos los usuarios del catálogo.

Herramientas

get_domains
- Obtiene y devuelve una lista de todos los dominios del catálogo.
get_services
- Obtiene y devuelve una lista de todos los servicios en el catálogo.
get_events
- Obtiene y devuelve una lista de todos los eventos en el catálogo.
get_commands
- Obtiene y devuelve una lista de todos los comandos en el catálogo
get_queries
- Obtiene y devuelve una lista de todas las consultas en el catálogo
get_flows
- Obtiene y devuelve una lista de todos los flujos en el catálogo
get_teams
- Obtiene y devuelve una lista de todos los equipos en el catálogo.
get_team
- Obtiene y devuelve un equipo del catálogo.
get_users
- Obtiene y devuelve una lista de todos los usuarios del catálogo.
get_user
- Obtiene y devuelve un usuario del catálogo.

Esquemas

get_event_schema
- Obtiene y devuelve el esquema para un ID de evento determinado
get_query_schema
- Obtiene y devuelve el esquema para un ID de consulta determinado
get_command_schema
- Obtiene y devuelve el esquema para un ID de comando determinado

API abierta

get_openapi_spec
- Obtiene y devuelve la especificación OpenAPI para un ID de servicio determinado
get_asyncapi_spec
- Obtiene y devuelve la especificación AsyncAPI para un ID de servicio determinado

¿Falta una API?

Estamos trabajando para añadir más API al servidor MCP. Si necesita algo específico, abra una incidencia y lo añadiremos al servidor.

HACER

Algunas ideas para el servidor MCP, ¡siéntete libre de agregarlas a la lista!

[ ] Agregar soporte para instancias de EventCatalog alojadas de forma privada
- Realizamos solicitudes de búsqueda a instancias de EventCatalog y permitimos que el usuario especifique encabezados personalizados o parámetros de autenticación que podemos agregar a cada solicitud.
[ ] Agregar indicaciones/herramientas para escribir en EventCatalog, si recibimos interés de la comunidad
[ ] Agregar soporte para obtener equipos y usuarios
[ ] Agregar soporte para obtener flujos de EventCatalog

Contribuyendo

Clonar el repositorio
Ejecute pnpm install para instalar las dependencias
Ejecutar pnpm run build

Para utilizar la compilación como su servidor MCP, puede apuntar su cliente MCP a la carpeta dist .

Ejemplo de cursor:

{
  "mcpServers": {
    "eventcatalog": {
      "command": "npx",
      "args": ["-y", "tsx /PATH_TO_YOUR_REPO/src/index.ts",  "https://demo.eventcatalog.dev"]
    }
  }
}

Patrocinadores

Gracias a nuestros patrocinadores del proyecto.

Patrocinadores de oro

Los patrocinadores contribuyen a la sostenibilidad de EventCatalog. ¿Quieres colaborar con el proyecto? ¡Contáctanos! O visita nuestra página de patrocinadores .

Soporte empresarial

¿Te interesa colaborar con nosotros? Ofrecemos soporte dedicado, asistencia prioritaria, desarrollo de funcionalidades, integraciones personalizadas y mucho más.

Encuentre más detalles en nuestra página de servicios .

Licencia

El uso de esta función es parte de EventCatalog Pro Edition

EventCatalog MCP Server

Integrations