EventCatalog MCP Server

Official

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Connects to EventCatalog instances that document Kafka-based architectures, enabling queries about event schemas, producers, consumers, and message flows

  • Integrates with Windsurf (Codeium's tool) to provide developers access to EventCatalog documentation, schemas, and architecture information directly in their development environment

ドキュメントを読む|デモを見る

特徴

  • 🤖 任意の MCP クライアント ( ClaudeCursorWindsurfなど) に接続します
  • 🤖 1 つのコマンドでローカルマシン上で MCP サーバーを実行します
  • 🤖 EventCatalogインスタンスに接続する
  • 🤖 アーキテクチャについて質問する
  • 🤖 OpenAPI と AsyncAPI の仕様について質問する
  • 🤖 ドメイン、サービス、メッセージなどについてお問い合わせください
  • 🤖 イベント、クエリ、コマンド、サービスのスキーマを取得します (OpenAPI、AsyncAPI、JSON スキーマ)

AIを活用してEventCatalogの価値を高める

EventCatalogは、イベント駆動型アーキテクチャのドキュメント作成を支援するオープンソースツールです。EventCatalogを使用すると、ドメイン、サービス、メッセージ、スキーマなど、さまざまな情報をドキュメント化できます。

EventCatalog は、アーキテクチャを視覚化し、関係者に意味を追加する機能を提供し、OpenPAI および AsyncAPI 仕様をホストし、世界中のあらゆるブローカーと統合します。

EventCatalog MCP サーバーを使用すると、既に使用しているツールのアーキテクチャについて質問することで、EventCatalog からより多くの価値を得ることができます。

  • 開発者は、MCP サーバーを MCP 対応の IDES (例: CursorWindsurf ) と統合できます。
  • 利害関係者は、使用しているツール(例: Claude )でアーキテクチャについて質問することができます。
  • MCPプロトコルをサポートしていないツールを使用している場合でも、 llms.txt標準を使用して他のLLLMツール( GeminiGPT-4など)と統合できます。

はじめる

インストール

まず、EventCatalog インスタンスでLLMS.txt機能を有効にする必要があります。

  1. eventcatalog.config.jsファイルを構成して、EventCatalog インスタンスでLLMS.txt機能を有効にします。
  2. LLMS.txt機能を有効にして EventCatalog インスタンスをデプロイします。

Smithery経由でインストール

Smithery経由で Claude Desktop 用の EventCatalog を自動的にインストールするには:

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

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}

プロジェクトの構成

プロジェクト内に.mcp.jsonファイルを作成し、Cursor を使用してプロジェクトの MCP サーバーを構成することもできます。

{ "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からフローを取得するためのサポートを追加

貢献

  1. リポジトリをクローンする
  2. pnpm install実行して依存関係をインストールします
  3. 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エディションの一部です

-
security - not tested
F
license - not found
-
quality - not tested

MCP クライアント (Claude、Cursor、Windsurf など) を EventCatalog インスタンスに接続するサーバー。ユーザーは開発ツール内で直接、イベント駆動型アーキテクチャに関する質問を行ったり、ドメイン、サービス、メッセージ スキーマに関する洞察を得たりすることができます。

  1. Using AI to get more value from EventCatalog
    1. Getting Started
      1. Installation
      2. Setup MCP Clients
      3. Adding the MCP server to Claude Desktop
      4. Adding the MCP server to Cursor
    2. API
      1. Resources
      2. Tools
      3. Missing an API?
      4. TODO
      5. Contributing
    3. Sponsors
      1. Gold sponsors
    4. Enterprise support
      1. License
        ID: dcneqo3wi9