阅读文档|查看演示

特征

• 🤖 连接到任何 MCP 客户端（ Claude 、 Cursor 、 Windsurf等）

• 🤖 使用一个命令在你的机器上本地运行 MCP 服务器

• 🤖 连接到您的 EventCatalog 实例

• 🤖 询问有关您的架构的问题

• 🤖 询问有关您的 OpenAPI 和 AsyncAPI 规范的问题

• 🤖 询问域名、服务和消息等更多信息

• 🤖 获取事件、查询、命令和服务的模式（OpenAPI、AsyncAPI、JSON Schema）

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 服务器的方式。

您可以在下面找到一些有用的链接来开始使用。

• 克劳德桌面

• 光标

将 MCP 服务器添加到 Claude Desktop

要将其与 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 服务器添加到 Cursor

转到光标设置 -> 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"]
    }
  }
}

您可以在Cursor 文档中阅读有关项目配置的更多信息。

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 版本的一部分