AsyncAPI MCP 서버

AI 어시스턴트가 AsyncAPI 사양에 액세스할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다. 코딩 도구에서 직접 사양을 검색, 탐색 및 가져올 수 있습니다.

기능

• 검색: 키워드로 AsyncAPI 사양 검색

• 가져오기: 제목이나 슬러그로 특정 섹션 가져오기

• 목록: GitHub 태그로 제공되는 모든 안정적인 사양 버전 나열

• 메타데이터 가져오기: 사양에 대한 메타데이터(버전, 소스, 캐시 정보, 크기) 확인

• 버전 인식: 릴리스된 모든 사양 버전을 쿼리하거나 기본값으로 최신 버전 사용

• 캐싱: ETag/Last-Modified 기반 HTTP 캐싱(태그 조회 시 10분 TTL)

Related MCP server: EasyPeasyMCP

사전 요구 사항

• Node.js v20 이상

설치

npm install

서버 실행

Streamable HTTP (로컬 개발)

npm run dev

서버는 기본적으로 http://localhost:3000/mcp에서 시작됩니다. 다른 포트를 사용하려면 PORT 환경 변수를 설정하세요:

PORT=8080 npm run dev

Stdio 전송 (원격 배포용)

npm start

이 명령은 호스팅된 MCP 서버의 표준 전송 방식인 stdio를 통해 서버를 실행합니다.

빌드

npm run build

src/의 TypeScript를 dist/로 컴파일합니다.

사용 가능한 도구

사용 가능한 리소스

AI 코딩 도구 설정

이 서버는 Streamable HTTP 전송을 사용합니다. AI 도구를 연결하기 전에 서버가 실행 중인지 확인하세요.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json(macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json(Windows)에 추가하세요:

{
  "mcpServers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Cursor

프로젝트 루트의 .cursor/mcp.json에 추가하세요:

{
  "mcpServers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

VS Code Copilot

프로젝트 루트의 .vscode/mcp.json에 추가하세요:

{
  "servers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp",
      "type": "http"
    }
  }
}

Windsurf

Windsurf MCP 설정에 추가하세요:

{
  "mcpServers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

Cline

Cline의 MCP 설정에 다음을 추가하세요:

{
  "mcpServers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

OpenCode

OpenCode 구성에 추가하세요:

{
  "mcp": {
    "servers": {
      "asyncapi": {
        "url": "http://localhost:3000/mcp"
      }
    }
  }
}

Zed

Zed의 settings.json에 추가하세요:

{
  "context_servers": {
    "asyncapi": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

사용 예시

설정이 완료되면 AI 어시스턴트에게 다음과 같이 질문할 수 있습니다:

• "AsyncAPI 사양에서 서버 객체에 대해 뭐라고 설명하나요?"

• "AsyncAPI 사양에서 'channels'를 검색해줘"

• "버전 2.6.0에서 Info Object 섹션을 가져와줘"

• "사용 가능한 모든 AsyncAPI 사양 버전 나열해줘"

• "AsyncAPI 2.x와 3.x의 메시지 차이점은 무엇인가요?"

• "스키마 정의에 대한 사양 섹션을 보여줘"

개발

# Install dependencies
npm install

# Build TypeScript to dist/
npm run build

# Run the HTTP server (local development)
npm run dev

# Run the stdio server (for deployment)
npm start

라이선스

MIT