brazilian-cep-mcp

描述

这是一个 MCP (模型上下文协议) 服务器，它提供用于查询巴西邮政编码 (CEP) 信息的工具。 该服务器使用 ViaCEP API 从提供的 CEP 获取详细的地址数据。

功能

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

安装

# 克隆存储库
git clone https://github.com/guilhermelirio/brazilian-cep-mcp.git
cd brazilian-cep-mcp

# 安装依赖项
npm install

如何使用

编译项目

要编译 TypeScript 代码：

npm run build

运行服务器

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

npm run dev

要在编译后启动服务器：

npm start

查询 CEP

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

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

使用示例：

{
  "cep": "01001000"
}

响应：

找到的地址：
CEP: 01001-000
街道：Praça da Sé
补充：lado ímpar
社区：Sé
城市：São Paulo
州：SP (São Paulo)
地区：东南
DDD: 11
IBGE: 3550308

使用的技术

• TypeScript
• Node.js
• Axios 用于 HTTP 请求
• Zod 用于模式验证
• 模型上下文协议 SDK

Smithery 配置

此项目配置为与 Smithery.ai 平台一起使用，该平台有助于 MCP 服务器的分配和执行。

项目结构

brazilian-cep-mcp/
├── src/
│   └── index.ts       # 主要源代码
├── dist/                # 编译后的代码
├── node_modules/        # 依赖项
├── smithery.yaml        # Smithery 配置
├── package.json         # 项目配置
├── tsconfig.json        # TypeScript 配置
└── README.md            # 此文件

作者

Guilherme Lirio Tomasi de Oliveira

许可

本项目采用 MIT 许可 - 有关详细信息，请参阅 LICENSE 文件。

贡献

欢迎贡献！ 随意打开 issue 或发送 pull request。