MCP-CEP

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

---

👤 作者

Wendell Barreto
https://github.com/wendellbigato

---

🚀 安装

1. 克隆此仓库

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

发布时，请将上述URL替换为实际的URL。

---

2. 创建并激活虚拟环境

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

---

3. 使用 uv 或 pip 安装依赖项

使用 uv：

uv pip install -e ".[cli]"

或使用普通的 pip：

pip install -e ".[cli]"

---

🧩 在Goose中配置为扩展

1. 执行：

goose configure

2. 选择 添加扩展

3. 选择 命令行扩展

4. 填写字段：

字段	值
扩展名称	mcp-cep
运行命令	/完整路径到/uv --directory /mcp-cep路径 run main.py
超时	300
环境	(留空，或根据需要自定义)

使用 which uv 和 pwd 查找正确的路径。

---

✅ 如何在Goose上测试

配置完成后，启动：

goose 

然后发送如下命令：

重复：你好！
邮政编码01001000的地址是什么？

---

🧰 可用工具

• echo(texto: str)重复发送的文本。
• buscar_cep(cep: str)通过ViaCEP获取地址信息。

---

📄 许可证

本项目采用MIT许可证。