brazilian-cep-mcp

描述

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

功能

• 通过CEP查询完整的地址
• 返回诸如街道、社区、城市、州、地区、区号和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
街道: 塞广场
补充: 单数边
社区: 塞
城市: 圣保罗
州: SP (圣保罗)
地区: 东南部
区号: 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文件以获取更多详情。

贡献

欢迎贡献！请随意打开问题或发送拉取请求。 </中文翻译>