brazilian-cep-mcp

描述

这是一个提供巴西邮政编码（CEP）信息查询工具的MCP（Model Context Protocol）服务器。该服务器使用ViaCEP API根据提供的邮政编码获取详细的地址数据。

功能

• 通过邮政编码查询完整地址
• 返回诸如街道、社区、城市、州、地区、DDD和IBGE代码等信息
• 实现MCP协议以与AI代理集成

安装

# Clone o repositório
git clone https://github.com/guilhermelirio/brazilian-cep-mcp.git
cd brazilian-cep-mcp

# Instale as dependências
npm install

如何使用

编译项目

要编译TypeScript代码：

npm run build

运行服务器

要在开发模式下启动服务器：

npm run dev

要运行已编译的服务器：

npm start

查询一个邮政编码

服务器提供了consultar-cep工具，它接受一个参数：

• cep: 8位数字格式的邮政编码（必填）

使用示例：

{
  "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

使用的技术

• TypeScript
• Node.js
• Axios 用于HTTP请求
• Zod 用于模式验证
• Model Context Protocol SDK

Smithery配置

此项目配置为与Smithery.ai平台一起工作，这有助于分发和执行MCP服务器。

项目结构

brazilian-cep-mcp/
├── src/
│   └── index.ts       # Código-fonte principal
├── dist/              # Código compilado
├── node_modules/      # Dependências
├── smithery.yaml      # Configuração do Smithery
├── package.json       # Configuração do projeto
├── tsconfig.json      # Configuração do TypeScript
└── README.md          # Este arquivo

作者

Guilherme Lirio Tomasi de Oliveira

许可证

本项目采用MIT许可证发布 - 查看LICENSE文件了解更多详情。

贡献

欢迎贡献！请随时提出问题或发送拉取请求。