BrasilAPI MCP 서버

브라질 리소스에서 다양한 데이터를 원활하게 쿼리하세요. 통합 인터페이스를 통해 우편번호, 지역번호, 은행, 공휴일, 세금 등의 정보에 액세스할 수 있습니다. BrasilAPI 의 풍부하고 최신 데이터를 활용하여 AI 에이전트와 애플리케이션을 손쉽게 개선하세요.

여기에서 BrasilAPI의 전체 공식 문서를 확인하세요.

도구

이 서버는 BrasilAPI에서 사용 가능한 모든 엔드포인트를 쿼리하는 도구를 제공합니다. 내부적으로는 다음 JS 클라이언트를 사용하여 API와 통신합니다. https://github.com/WillianAgostini/brasilapi-js

Smithery의 도구 페이지를 확인하여 각 도구를 검사하고 테스트해 보세요.

개발

종속성 설치:

지엑스피1

서버를 빌드하세요:

npm run build

자동 재빌드를 사용한 개발의 경우:

npm run watch

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.

npm run inspector

업데이트된 빌드를 생성하고 검사하려면:

npm run build-and-inspect

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.

AI 애플리케이션과의 통합

스미서리를 통과하다

Smithery 를 통해 서버를 자동으로 실행합니다.

npx -y @smithery/cli install @mauricio-cantu/brasil-api-mcp-server

Claude와 함께 사용

npx -y @smithery/cli@latest install @mauricio-cantu/brasil-api-mcp-server --client claude

커서 및 기타 통합

다른 통합 옵션(커서 등)을 알아보려면 Smithery 의 서버 페이지를 확인하세요.

로컬 복사본으로 서버 실행

이 프로젝트를 다운로드한 후 node 사용하여 서버를 실행할 수 있습니다.

node /absolute/path/to/brasil-api-mcp-server/build/index.js

프로젝트의 루트에는 원하는 경우 이미지를 빌드하고 실행할 수 있는 Dockerfile도 있습니다.

서버 기능 검사

Smithery를 사용하여 이 MCP 서버의 기능을 검사할 수 있습니다.

npx -y @smithery/cli@latest inspect @mauricio-cantu/brasil-api-mcp-server

여기에는 사용 가능한 모든 도구, 매개변수, 사용 방법이 표시됩니다.

프로젝트 구조

src/
  ├── apiClient/   # BrasilAPI client
  ├── tools/       # Tools implementations
  ├── types/       # Interfaces and types
  ├── utils/       # Utility functions
  └── index.ts     # MCP main file (server setup and tools listing)