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

特徴

• 🤖 任意の MCP クライアント ( Claude 、 Cursor 、 Windsurfなど) に接続します

• 🤖 1 つのコマンドでローカルマシン上で MCP サーバーを実行します

• 🤖 EventCatalogインスタンスに接続する

• 🤖 アーキテクチャについて質問する

• 🤖 OpenAPI と AsyncAPI の仕様について質問する

• 🤖 ドメイン、サービス、メッセージなどについてお問い合わせください

• 🤖 イベント、クエリ、コマンド、サービスのスキーマを取得します (OpenAPI、AsyncAPI、JSON スキーマ)

Related MCP server: mcp-openapi-schema

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機能を有効にする必要があります。

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エディションの一部です