MCP-CEP

ViaCEPパブリック API を使用して郵便番号を照会するための MCP サーバー。
コマンドライン拡張機能としてGooseと互換性があります。

👤 著者

ウェンデル・バレット
https://github.com/wendellbigato

🚀 インストール

1. このリポジトリをクローンする

git clone https://github.com/wendellbigato/mcp-cep.git
cd mcp-cep

投稿の際は上記のURLを実際のものに変更してください。

2. 仮想環境を作成してアクティブ化する

python3.11 -m venv .venv
source .venv/bin/activate  # Linux/macOS
# ou
.venv\Scripts\activate.bat  # Windows

3. uvまたはpipで依存関係をインストールする

uvの使用:

uv pip install -e ".[cli]"

または通常のpipの場合:

pip install -e ".[cli]"

Related MCP server: Brazilian ZIP Code Lookup

🧩 Gooseで拡張機能として設定する

1. 実行する：

goose configure

2. Add Extension選択

3. Command-line Extensionを選択

4. 以下のフィールドに入力します:

which uvとpwdを使用して正しいパスを見つけます。

✅ Gooseでテストする方法

セットアップ後、開始します:

goose session --with-extension mcp-cep

次のようなコマンドを送信します。

Repita: Olá!
Qual o endereço do CEP 01001000?

🧰 利用可能なツール

• echo(texto: str) : 送信されたテキストを繰り返します。

• buscar_cep(cep: str) : ViaCEP 経由でアドレス情報をクエリします。

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています。