mcpField
M
mcp-brasil-api

mcp-brasil-api

ローカル
github.com/codespar法務・行政2754 週間前に更新
リポジトリ

mcp-brasil-api について

BrasilAPI の公開データ検索を AI エージェントから利用できる MCP サーバーです。認証不要で、ブラジルの郵便番号、企業、銀行、祝日、車両価格、天気などを照会できます。

主な機能

  1. 0124 種類の検索ツール
  2. 02CEP 住所と CNPJ 企業情報の照会
  3. 03銀行、祝日、FIPE 車両データの検索
  4. 04天気、税率、IBGE 地域データの取得
  5. 05API キーと環境変数が不要

活用シーン

  1. 01CEP からブラジルの住所を検索
  2. 02CNPJ から企業情報を調べる
  3. 03FIPE の車両価格を確認
  4. 04都市の天気や年間祝日を取得

MCP 対応

BrasilAPI の公開データ検索を MCP クライアント向けのツールとして提供します。認証は不要です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "codespar-mcp-brasil-api": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-brasil-api"
      ]
    }
  }
}
起動コマンドnpx -y @codespar/mcp-brasil-api

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@codespar/mcp-brasil-api0.2.2

ツール

24

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
cepstringはいCEP（8 桁の数字、例：01001000）

詳細

@codespar/mcp-brasil-api

BrasilAPI 用 MCP サーバー — CEP、CNPJ、銀行、祝日、FIPE などに関する無料の公開データ API

npm License: MIT

クイックスタート

Claude Desktop

~/.config/claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "brasil-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-brasil-api"]
    }
  }
}
Claude Code
claude mcp add brasil-api -- npx @codespar/mcp-brasil-api
Cursor / VS Code

.cursor/mcp.json または .vscode/mcp.json に追加します。

{
  "servers": {
    "brasil-api": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-brasil-api"]
    }
  }
}

ツール（24）

ツール用途
get_cepCEP（ブラジルの郵便番号）から住所を検索します
get_cnpjCNPJ から企業情報を検索します
get_banksコードと名称を含むブラジルの全銀行を一覧表示します
get_holidays指定した年の国民の祝日を一覧表示します
get_fipe_brandsFIPE テーブルから車種別に車両ブランドを一覧表示します
get_fipe_priceコードを指定して、FIPE テーブルから車両価格を取得します
get_dddDDD（市外局番）に対応する州と都市を取得します
get_isbnISBN から書籍情報を検索します
get_ncmNCM 税分類コードを検索します
get_cptec_weather都市の天気予報を取得します（CPTEC/INPE）
get_pix_participantsPix 参加機関（Pix に登録された PSP／銀行）を一覧表示します
get_domain_info.br ドメインの登録情報を検索します
get_ibge_municipalitiesブラジルの州に属する全自治体を一覧表示します（IBGE データ）
get_tax_rates現在のブラジルの税率・経済指標（Selic、CDI、IPCA）を取得します
get_cptec_cities天気予報用に、CPTEC/INPE の都市を名称で検索します
get_cep_v1BrasilAPI v1 を使って CEP から住所を検索します（単一プロバイダーのため、多くの場合 v2 より高速です）
get_fipe_vehiclesFIPE ブランドコードと車両タイプを指定して、車両モデルを一覧表示します
get_fipe_tablesFIPE 参照テーブルを一覧表示します（FIPE クエリで利用可能な月／年）
get_cptec_airport_weatherICAO コードから CPTEC/INPE の現在の空港気象情報（METAR）を取得します
get_cptec_capitals_weatherブラジルの全州都の現在の気象状況を取得します
get_cptec_ocean_forecast沿岸都市の海況・波浪予報を取得します（CPTEC/INPE）
get_ibge_statesIBGE コードとメタデータを含むブラジルの全州／UF を一覧表示します
get_corretorasCVM に登録されているブラジルの全証券会社（corretoras）を一覧表示します
get_corretoraCNPJ で CVM 登録済みの証券会社を個別に検索します

認証

認証は不要です。BrasilAPI は無料の公開 API です。

サンドボックス／テスト

サンドボックスは不要です。BrasilAPI は無料で、すべてのリクエストに対して公開されています。

認証情報の取得

認証情報は不要です。インストールして、そのまま使用できます。

環境変数

環境変数は不要です。

ロードマップ

v0.2（予定）
  • get_pix_participants — Pix 参加機関の一覧を取得します
  • get_domain_info — ドメイン登録情報を取得します
  • get_vehicle_info — ナンバープレートから車両情報を取得します（FIPE）
  • get_ibge_municipalities — 州別に自治体を一覧表示します（IBGE）
  • get_tax_rates — 現在の税率（Selic、CDI、IPCA）を取得します
v0.3（予定）
  • get_cvm_funds — CVM の投資信託データを取得します
  • get_election_results — 地域別に選挙結果を取得します

コントリビュートをご希望ですか？PR を作成するか、ツールをリクエストしてください。

リンク

エンタープライズ

エージェントによる支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。