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の場合:
🧩 Gooseで拡張機能として設定する
- 実行する:
Add Extension
選択Command-line Extension
を選択- 以下のフィールドに入力します:
分野 | 価値 |
---|
拡張機能名 | mcp-cep |
実行するコマンド | /caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py |
タイムアウト | 300 |
環境 | (空白、または必要に応じてカスタマイズ) |
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 ライセンスに基づいてライセンスされています。