TalkEventsToMe

TalkEventsToMe

MCP（Model Context Protocol）サーバーを介して EventCatalog と連携し、イベント駆動型アーキテクチャに関する疑問や知見を探ることに焦点を当てた学習プロジェクトです。

🎯 プロジェクトの目的

このプロジェクトでは、EventCatalog MCP Server を活用して、組織の EventCatalog インスタンスとやり取りし、Claude、Cursor、Windsurf などの AI アシスタントからイベント駆動型アーキテクチャに関する知見を直接得る方法を紹介します。

🏗️ アーキテクチャの概要

• EventCatalog インスタンス：https://eventcatalog.compassdigital.org/（Google OAuth で保護）
• MCP サーバー：@eventcatalog/mcp-server
• クライアント：MCP 統合を備えた Cursor IDE
• 認証：EventCatalog Scale ライセンスキーが必要です

🚀 セットアップ手順

前提条件

1. EventCatalog Scale ライセンス：EventCatalog Scale のライセンスキーが必要です

   • EventCatalog Cloud から14日間のトライアルを利用できます
   • .mcp.json 内の YOUR_EVENTCATALOG_SCALE_LICENSE_KEY を置き換えてください

2. EventCatalog インスタンスへのアクセス：https://eventcatalog.compassdigital.org/ にアクセスできることを確認してください

インストール

1. MCP サーバーの設定：このプロジェクトでは .mcp.json ファイルがすでに設定されています
2. 依存関係のインストール：MCP サーバーは npx を介して自動的にインストールされます
3. Cursor の再起動：.mcp.json を更新した後、Cursor を再起動して MCP サーバーを読み込んでください

動作確認

設定が完了すると、Cursor で EventCatalog MCP サーバーが利用可能になります。イベントカタログについて質問して、動作を確認できます。

🤖 利用可能な MCP ツール

EventCatalog MCP サーバーでは、次のツールを利用できます。

ツール

• find_resources - EventCatalog で利用可能なリソースを検索します
• find_resource - サービス、ドメイン、イベント、コマンド、クエリ、フローに関する詳細情報を取得します
• find_producers_and_consumers - サービスのプロデューサーとコンシューマーを取得します
• get_schema - サービス、イベント、コマンド、クエリのスキーマを返します
• review_schema_changes - スキーマの変更を確認し、互換性を損なう変更を検出します
• explain_ubiquitous_language_terms - ドメイン固有の用語を説明します

リソース

• eventcatalog://all - すべてのメッセージ、ドメイン、サービス
• eventcatalog://events - すべてのイベント
• eventcatalog://domains - すべてのドメイン
• eventcatalog://services - すべてのサービス
• eventcatalog://queries - すべてのクエリ
• eventcatalog://commands - すべてのコマンド
• eventcatalog://flows - すべてのフロー
• eventcatalog://teams - すべてのチーム
• eventcatalog://users - すべてのユーザー

🔍 学習課題

このプロジェクトでは、次の重要な疑問を探ります。

メニュー公開イベント

1. 新しいメニューが公開されたときにイベントは発生しますか？
2. そのイベントを所有するチームはどこですか？
3. そのイベントをサブスクライブするにはどうすればよいですか？
4. そのイベントを処理するために、どのような情報が必要ですか？
5. メニューサービスに関連するほかのイベントはありますか？

イベントの登録と検出

6. 独自のサービスがある場合、EventCatalog に新しいイベントを登録するにはどうすればよいですか？
7. 新しいイベントを登録したときに誰かに通知する必要がありますか？ また、ほかの人はどのようにしてそのイベントをサブスクライブできますか？

アーキテクチャに関する知見

8. イベント駆動型アーキテクチャに関する情報はありますか？
9. メニューが公開されるタイミングと、そのイベントのすべてのサブスクライバーを示すイベントフローを作成できますか？

エラー処理と信頼性

10. イベントの配信に失敗した場合、サブスクライバーはその状況をどのように把握できますか？

🎓 学習目標

このプロジェクトを通じて、次のことを学べます。

• EventCatalog 連携用の MCP サーバーを設定する方法
• イベント駆動型アーキテクチャのドキュメントをプログラムから照会する方法
• アーキテクチャ内のイベント、スキーマ、関係性を見つける方法
• チームの所有権と責任を理解する方法
• イベントフローと依存関係を特定する方法
• エラー処理と信頼性のパターンを調べる方法

📚 リソース

• EventCatalog MCP サーバーの GitHub
• EventCatalog MCP ドキュメント
• 当社の EventCatalog インスタンス
• MCP プロトコルのドキュメント

🔧 トラブルシューティング

よくある問題

1. ライセンスキーの問題：EventCatalog Scale のライセンスキーが有効で、期限切れでないことを確認してください
2. ネットワークアクセス：ネットワークから EventCatalog インスタンスにアクセスできることを確認してください
3. OAuth の問題：EventCatalog インスタンスに Google OAuth で認証されていることを確認してください
4. MCP サーバーが読み込まれない：.mcp.json を変更した後、Cursor を再起動してください

デバッグコマンド

# Test MCP server installation
npx -y @eventcatalog/mcp-server --help

# Verify EventCatalog accessibility
curl -I https://eventcatalog.compassdigital.org/

📝 メモ

• このプロジェクトは学習と探索を目的としています
• EventCatalog インスタンスは Google OAuth で保護されています
• すべての機能を利用するには EventCatalog Scale のライセンスが必要です
• MCP 統合は Claude、Cursor、Windsurf などの MCP 対応クライアントで動作します

🤝 貢献

これは個人の学習プロジェクトですが、以下の貢献を歓迎します：

• 質問の例を追加する
• 興味深い発見を記録する
• イベント駆動アーキテクチャのパターンに関する知見を共有する
• セットアップのドキュメントを改善する

📄 ライセンス

このプロジェクトは教育目的です。EventCatalog および関連ツールのライセンス条項を遵守してください。