MCP-CEP

使用ViaCEP公共API查询CEP的MCP服务器。
兼容Goose作为命令行扩展（Command-line Extension）。

---

👤 作者

Wendell Barreto
https://github.com/wendellbigato

---

🚀 安装

1. 克隆此仓库

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

发布时请将上面的URL替换为实际地址。

---

2. 创建并激活虚拟环境

bash
python3.11 -m venv .venv
source .venv/bin/activate # Linux/macOS

或者

.venvScriptsactivate.bat # Windows

---

3. 使用uv或pip安装依赖

使用uv:

bash
uv pip install -e ".[cli]"

或者使用普通的pip:

bash
pip install -e ".[cli]"

---

🧩 在Goose中配置为扩展

1. 运行：

bash
goose configure

1. 选择 Add Extension

2. 选择 Command-line Extension

3. 填写字段：

字段	值
Extension name	mcp-cep
Command to run	/caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py
Timeout	300
Environment	(留空，或根据需要自定义)

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

---

✅ 如何在Goose中测试

配置完成后，启动：

bash
goose session --with-extension mcp-cep

然后发送如下命令：

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

---

🧰 可用工具

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

---

📄 许可证

本项目采用MIT许可证。