MCP-CEP
Servidor MCP para consulta de CEPs usando a API pública do ViaCEP.
Compatível com Goose como extensão de linha de comando (Command-line Extension).
👤 Autor
Wendell Barreto
https://github.com/wendellbigato
🚀 Instalação
1. Clone este repositório
Altere a URL acima para a real quando publicar.
2. Crie e ative o ambiente virtual
3. Instale as dependências com uv
ou pip
Usando uv:
Ou com pip normal:
🧩 Configurando como extensão no Goose
- Execute:
- Selecione
Add Extension
- Escolha
Command-line Extension
- Preencha os campos:
Campo | Valor |
---|---|
Extension name | mcp-cep |
Command to run | /caminho/completo/para/uv --directory /caminho/para/mcp-cep run main.py |
Timeout | 300 |
Environment | (em branco, ou personalize se necessário) |
Use which uv
e pwd
para encontrar os caminhos corretos.
✅ Como testar no Goose
Após configurar, inicie:
E envie comandos como:
🧰 Ferramentas disponíveis
echo(texto: str)
: repete o texto enviado.buscar_cep(cep: str)
: consulta informações de endereço via ViaCEP.
📄 Licença
Este projeto está licenciado sob a licença MIT.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
使用 ViaCEP 公共 API 查询巴西邮政编码 (CEP) 的服务器,与 Goose 兼容作为命令行扩展。
Related MCP Servers
- AsecurityAlicenseAqualityA server that enables interaction with Square's API via Goose, supporting queries for locations, customers, and more with context preservation and MCP-compliant responses.Last updated -123PythonMIT License
- -securityAlicense-qualityA Goose MCP extension providing voice interaction with modern audio visualization, allowing users to communicate with Goose through speech rather than text.Last updated -60PythonMIT License
- AsecurityFlicenseAqualityQuery a variety of data from Brasil resources seamlessly. Access information on postal codes, area codes, banks, holidays, taxes, and more through a unified interface. Enhance your AI agents and applications with rich and updated data from BrasilAPI effortlessly.Last updated -65TypeScript
- AsecurityAlicenseAqualityAn MCP server that enables querying detailed address information from Brazilian postal codes (CEPs) via the ViaCEP API, returning data such as street names, neighborhoods, cities, states, regions, and IBGE codes.Last updated -11TypeScriptMIT License