BrasilAPI MCP Server

BrasilAPI MCP Server

Brasil のさまざまなリソースから、幅広いデータを簡単に取得できます。統一されたインターフェースを通じて、郵便番号、市外局番、銀行、祝日、税金などの情報にアクセスできます。BrasilAPI の豊富で最新のデータを活用して、AI エージェントやアプリケーションを手軽に強化できます。

BrasilAPI の完全な公式ドキュメントはこちらをご覧ください。

ツール

このサーバーは、BrasilAPI で利用可能なすべてのエンドポイントを照会するツールを提供します。内部では、この JS クライアントを使用して API と通信します：https://github.com/WillianAgostini/brasilapi-js

各ツールの詳細を確認してテストするには、Smithery のツールページをご覧ください。

開発

依存関係をインストールします：

npm install

サーバーをビルドします：

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグが難しい場合があります。MCP Inspector の使用をおすすめします。これはパッケージスクリプトとして利用できます：

npm run inspector

ビルドを更新して調査するには：

npm run build-and-inspect

Inspector により、ブラウザーでデバッグツールにアクセスするための URL が表示されます。

AI アプリケーションとの連携

Smithery 経由で実行する

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

Cursor などとの連携

Cursor などの連携オプションについては、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)