BrasilAPI MCP サーバー

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

インスペクターは、ブラウザでデバッグツールにアクセスするための URL を提供します。

AIアプリケーションとの統合

鍛冶屋を駆け抜ける

Smithery経由でサーバーを自動的に実行します。

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

クロードとの使用

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)