brazilian-cep-mcp
2025.03.18
0
TypeScript地址查询巴西邮政编码服务位置服务
brazilian-cep-mcp 是一个基于 Model Context Protocol (MCP) 的服务，专门用于查询巴西的邮政编码（CEP）信息。它通过 ViaCEP API 获取详细的地址数据，包括街道、社区、城市、州、地区、DDD 和 IBGE 代码等信息。该服务旨在为 AI 代理提供集成的地址查询功能。
View on GitHub
Overview
基本能力
产品定位
brazilian-cep-mcp 是一个专门用于查询巴西邮政编码（CEP）信息的服务，通过 MCP 协议与 AI 代理集成，提供详细的地址数据查询功能。
核心功能
- 通过 CEP 查询完整的地址信息
- 返回包括街道、社区、城市、州、地区、DDD 和 IBGE 代码等详细信息
- 基于 MCP 协议实现，便于与 AI 代理集成
适用场景
- 需要查询巴西地址信息的应用或服务
- AI 代理或自动化流程中需要集成地址查询功能
- 开发基于位置服务的应用
工具列表
consultar-cep：查询 CEP 的工具，接受一个 8 位数字的 CEP 参数，返回详细的地址信息。
常见问题解答
- 无明确常见问题解答部分。
使用教程
使用依赖
安装 Node.js 和 npm 是运行此服务的前置依赖。
安装教程
# 克隆仓库
git clone https://github.com/guilhermelirio/brazilian-cep-mcp.git
cd brazilian-cep-mcp
# 安装依赖
npm install
调试方式
编译项目
npm run build
运行服务器
开发模式：
npm run dev
生产模式（需先编译）：
npm start
查询 CEP 示例
{
"cep": "01001000"
}
返回示例：
Endereço encontrado:
CEP: 01001-000
Logradouro: Praça da Sé
Complemento: lado ímpar
Bairro: Sé
Cidade: São Paulo
Estado: SP (São Paulo)
Região: Sudeste
DDD: 11
IBGE: 3550308