MCP-CEP

MCP 服务器使用ViaCEP公共 API 查询邮政编码。
与Goose兼容作为命令行扩展。

👤 作者

温德尔·巴雷托
https://github.com/wendellbigato

🚀 安装

1. 克隆此存储库

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

发帖时请将以上网址更改为真实网址。

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 许可。