특징

🤖 모든 MCP 클라이언트( Claude , Cursor , Windsurf 등)에 연결
🤖 하나의 명령으로 컴퓨터에서 로컬로 MCP 서버를 실행하세요
🤖 EventCatalog 인스턴스에 연결
🤖 아키텍처에 대한 질문을 해보세요
🤖 OpenAPI 및 AsyncAPI 사양에 대해 질문하세요
🤖 도메인, 서비스, 메시지 등에 대해 문의하세요
🤖 이벤트, 쿼리, 명령 및 서비스에 대한 스키마를 가져옵니다(OpenAPI, AsyncAPI, JSON 스키마)

AI를 사용하여 EventCatalog에서 더 많은 가치 얻기

EventCatalog 는 이벤트 기반 아키텍처를 문서화하는 데 도움이 되는 오픈 소스 도구입니다. EventCatalog를 사용하면 도메인, 서비스 및 메시지, 스키마 등을 문서화할 수 있습니다.

EventCatalog는 여러분 모두를 위해 아키텍처를 시각화하고, 이해관계자에게 의미적 의미를 추가하는 기능을 제공하고, OpenPAI 및 AsyncAPI 사양을 호스팅하고 전 세계의 모든 브로커와 통합합니다.

EventCatalog MCP 서버를 사용하면 이미 사용 중인 도구에서 아키텍처에 대한 질문을 통해 EventCatalog에서 더 많은 가치를 얻을 수 있습니다.

개발자는 MCP 서버를 MCP 지원 IDES(예: Cursor , Windsurf )와 통합할 수 있습니다.
이해 관계자는 자신이 사용하는 도구(예: Claude )에서 아키텍처에 대한 질문을 할 수 있습니다.
MCP 프로토콜을 지원하지 않는 도구를 사용하는 경우에도 llms.txt 표준을 사용하여 다른 LLLM 도구(예: Gemini , GPT-4 )와 통합할 수 있습니다.

시작하기

설치

먼저, EventCatalog 인스턴스에서 LLMS.txt 기능을 활성화해야 합니다.

eventcatalog.config.js 파일을 구성하여 EventCatalog 인스턴스에서 LLMS.txt 기능을 활성화합니다.
LLMS.txt 기능을 활성화하여 EventCatalog 인스턴스를 배포합니다.

Smithery를 통해 설치

Smithery 를 통해 Claude Desktop용 EventCatalog를 자동으로 설치하려면:

지엑스피1

MCP 클라이언트 설정

각 MCP 클라이언트는 MCP 서버를 추가하는 방법이 다릅니다.

아래에서 시작하는 데 도움이 되는 몇 가지 유용한 링크를 찾아보세요.

클로드 데스크탑
커서

Claude Desktop에 MCP 서버 추가

Claude Desktop에서 이 기능을 사용하려면 claud_desktop_config.json 파일에 다음을 추가하세요. MacOS의 전체 경로는 ~/Library/Application Support/Claude/claud_desktop_config.json , 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
      ]
    }
  }
}

커서에 MCP 서버 추가

커서 설정 -> MCP 서버 -> MCP 서버 추가로 이동합니다.

이름: eventcatalog
명령어: npx
인수: -y @eventcatalog/mcp-server {URL_TO_YOUR_EVENTCATALOG_INSTANCE}

프로젝트 구성

Cursor를 사용하여 프로젝트에 대한 MCP 서버를 구성하려면 프로젝트에서 .mcp.json 파일을 만들 수도 있습니다.

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

커서 설명서 에서 프로젝트 구성에 대한 자세한 내용을 읽을 수 있습니다.

API

다음은 MCP 서버가 지원하는 모든 API 목록입니다.

자원

eventcatalog://all
- 카탈로그의 모든 메시지, 도메인, 서비스를 반환합니다.
eventcatalog://domains
- 카탈로그의 모든 도메인을 반환합니다.
eventcatalog://services
- 카탈로그의 모든 서비스를 반환합니다.
eventcatalog://events
- 카탈로그의 모든 이벤트를 반환합니다.
eventcatalog://queries
- 카탈로그의 모든 쿼리를 반환합니다.
eventcatalog://commands
- 카탈로그의 모든 명령을 반환합니다.
eventcatalog://flows
- 카탈로그의 모든 흐름을 반환합니다.
eventcatalog://teams
- 카탈로그의 모든 팀을 반환합니다.
eventcatalog://users
- 카탈로그의 모든 사용자를 반환합니다.

도구

get_domains
- 카탈로그의 모든 도메인 목록을 가져와서 반환합니다.
get_services
- 카탈로그에 있는 모든 서비스 목록을 가져와서 반환합니다.
get_events
- 카탈로그의 모든 이벤트 목록을 가져와서 반환합니다.
get_commands
- 카탈로그에 있는 모든 명령 목록을 가져와서 반환합니다.
get_queries
- 카탈로그의 모든 쿼리 목록을 가져와서 반환합니다.
get_flows
- 카탈로그의 모든 흐름 목록을 가져와 반환합니다.
get_teams
- 카탈로그에 있는 모든 팀의 목록을 가져와서 반환합니다.
get_team
- 카탈로그에서 팀을 가져오고 반환합니다.
get_users
- 카탈로그에 있는 모든 사용자 목록을 가져와서 반환합니다.
get_user
- 카탈로그에서 사용자를 가져오고 반환합니다.

스키마

get_event_schema
- 지정된 이벤트 ID에 대한 스키마를 가져오고 반환합니다.
get_query_schema
- 주어진 쿼리 ID에 대한 스키마를 가져와 반환합니다.
get_command_schema
- 주어진 명령 ID에 대한 스키마를 가져오고 반환합니다.

오픈API

get_openapi_spec
- 지정된 서비스 ID에 대한 OpenAPI 사양을 가져오고 반환합니다.
get_asyncapi_spec
- 지정된 서비스 ID에 대한 AsyncAPI 사양을 가져오고 반환합니다.

API가 없나요?

MCP 서버에 더 많은 API를 추가하기 위해 노력하고 있습니다. 특정 기능이 필요하시면 이슈를 남겨 주세요. 서버에 추가해 드리겠습니다.

할 일

MCP 서버에 대한 몇 가지 아이디어가 있으면 목록에 추가해 보세요!

[ ] 개인 호스팅 EventCatalog 인스턴스에 대한 지원 추가
- EventCatalog 인스턴스에 대한 가져오기 요청을 만들고, 사용자가 각 요청에 추가할 수 있는 사용자 정의 헤더나 인증 매개변수를 지정하도록 합니다.
[ ] 커뮤니티에서 관심을 얻으면 EventCatalog에 쓰기 위한 프롬프트/도구를 추가합니다.
[ ] 팀과 사용자를 위한 지원 추가
[ ] EventCatalog에서 흐름을 가져오기 위한 지원 추가

기여하다

저장소를 복제합니다
종속성을 설치하려면 pnpm install 실행하세요.
pnpm run build 실행하세요

빌드를 MCP 서버로 사용하려면 MCP 클라이언트를 dist 폴더로 가리키면 됩니다.

커서의 예:

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

스폰서

프로젝트 후원사들에게 감사드립니다.

골드 스폰서

스폰서는 EventCatalog의 지속 가능성을 높이는 데 도움을 줍니다. 프로젝트에 도움을 주고 싶으신가요? 연락해 주세요! 또는 스폰서 페이지를 방문해 주세요 .

기업 지원

저희와 함께 협업하고 싶으신가요? 전담 지원, 우선 지원, 기능 개발, 맞춤형 통합 등 다양한 서비스를 제공합니다.

자세한 내용은 서비스 페이지 에서 확인하세요.

특허

이 기능의 사용은 EventCatalog Pro Edition 의 일부입니다.

EventCatalog MCP Server

Integrations

특징