AsyncAPI MCP Server

An MCP server for AsyncAPI: parse and summarize specs, validate, lint (Spectral), convert versions, generate models (Modelina), and run the AsyncAPI Generator from any MCP client (Cursor, Claude Desktop, VS Code, and others). Uses stdio by default—no port or API key for core features.

Tools

Most tools take source: inline YAML/JSON or an absolute path to a .yaml, .yml, or .json file. For full parameter shapes (enums, optional fields), use your MCP client’s tool definitions.

| Tool | Purpose | |------|---------| | get_asyncapi_info | AsyncAPI version, default content type, and info block (contact, license, tags, etc.) | | list_asyncapi_servers | Servers: URLs, hosts, protocols, variables, binding summaries | | list_asyncapi_channels | Channels: addresses, parameters, message ids, bindings | | list_asyncapi_operations | Operations: actions, operationId, linked channels and messages | | list_asyncapi_messages | Messages: one-line payload shape; optional headers summary | | validate_document | Parser validation: issues with severity, message, path, codes | | lint_spec | Spectral lint; optional custom ruleset path | | convert_spec | Convert toward a target spec version (e.g. 2.x → 3.x); needs targetVersion and optional output options | | generate_models | Typed models via Modelina; needs language and optional Modelina options | | generate | Generate from a template; needs template, absolute targetDir, optional templateParams |

convert_spec, generate_models, and generate require extra arguments beyond source; see each tool’s schema in the client.

Prerequisites

• Node.js 24.11+ (see package.json → engines).

Installation

Published package

npm install -g asyncapi-mcp-server

On demand:

npx -y asyncapi-mcp-server

If npx cold-start times out your client, install globally once and point the client at the asyncapi-mcp-server binary.

From source

git clone https://github.com/Adi-204/asyncapi-mcp-server.git
cd asyncapi-mcp-server
npm install && npm run build

Use node /absolute/path/to/asyncapi-mcp-server/dist/index.js in MCP config.

Usage

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "asyncapi": {
      "command": "npx",
      "args": ["-y", "asyncapi-mcp-server"]
    }
  }
}

For a local build, replace with "command": "node" and "args": ["/absolute/path/to/asyncapi-mcp-server/dist/index.js"].

Cursor

Settings → MCP: command npx, args -y, asyncapi-mcp-server (or node + path to dist/index.js for local dev).

VS Code

In User Settings JSON or .vscode/mcp.json:

{
  "servers": {
    "asyncapi": {
      "command": "npx",
      "args": ["-y", "asyncapi-mcp-server"]
    }
  }
}

Build

Entrypoint: dist/index.js (ESM).

npm install
npm run build

Development

Inspector: npm run inspect. Clone setup, tests, layout: DEVELOPMENT.md. Contributions: CONTRIBUTING.md.

License

Apache-2.0 — see LICENSE and package.json.