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:
🧩 在 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 许可。