Ghana Post Gps MCP

加纳邮政GPS MCP服务器

一种模型上下文协议（MCP）服务器，将加纳邮政GPS地址转换为包括坐标在内的详细位置信息。

特性

• GPS地址查找：将加纳邮政GPS代码（例如“GA-554-3608”）转换为详细的位置信息
• 地址验证：处理前验证GPS代码格式
• 批处理：一次查找多个GPS地址（最多10个）
• 附近坐标：在已知位置的指定半径内生成坐标
• 真正的API集成：使用实际的加纳邮政GPS API

安装

先决条件

• Node.js 18.0.0或更高版本
• npm

设置

1. 克隆或下载此项目

1. 安装依赖项:

   npm install

1. 构建项目:

   npm run build

用法

发展模式

npm run dev

生产模式

npm run start

测试

# Test server connection
npm run test

# Test GPS lookup
npm run test-lookup

可用工具

1.lookup_gps_address

将加纳邮政GPS地址转换为详细的位置信息。

输入:

• gps_code （字符串）：GPS地址码（例如“GA-554-3608”）

输出：位置详细信息，包括坐标、街道、地区、地区、区域和邮政编码。

2.验证码

验证字符串是否与加纳邮政GPS地址格式匹配。

输入:

• gps_code （string）：要验证的GPS代码

输出：带有格式信息和示例的验证结果。

3.批处理_备份_gps

一次查找多个GPS地址（最多10个）。

输入:

• gps_codes （array）：要查找的GPS代码数组

输出：所有提供的带有状态信息的GPS代码的结果。

4.查找查找坐标

生成已知GPS位置半径内的坐标。

输入:

• gps_code （string）：基础GPS代码
• radius_km （数字，可选）：搜索半径，单位为公里（默认值：1）
• count （数字，可选）：要生成的点数（默认值：5）

输出：基本位置信息和附近坐标数组。

Claude桌面集成

要将此MCP服务器与Claude Desktop一起使用：

视窗

1. 编辑 %APPDATA%\\Claude\\claude_desktop_config.json
2. 添加服务器配置：

{
  "mcpServers": {
    "ghana-post-gps": {
      "command": "node",
      "args": ["C:\\Users\\FRANKO\\OneDrive\\Desktop\\ghana-post-mcp\\dist\\index.js"],
      "env": {}
    }
  }
}

macOS

1. 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json
2. 添加服务器配置：

{
  "mcpServers": {
    "ghana-post-gps": {
      "command": "node",
      "args": ["/path/to/ghana-post-mcp/dist/index.js"],
      "env": {}
    }
  }
}

Linux

1. 编辑 ~/.config/Claude/claude_desktop_config.json
2. 使用适当的路径添加服务器配置。

GPS地址格式

加纳邮政GPS地址遵循以下格式：

• 格式: XX-YYY-ZZZZ
• XX个：2个字母的地区代码（例如GA、AK、CP）
• YYY：3位区号
• ZZZZ：3-4位位置代码

例子

• GA-554-3608 （大阿克拉）
• AK-039-5028 （阿散蒂）
• CP-078-2542 （中央）

api信息

此服务器使用加纳邮政GPS API端点：

• 统一资源定位符: https://ghanapostgps.sperixlabs.org/get-location
• 方法：POST
• 内容类型: application/x-www-form-urlencoded

发展

项目结构

ghana-post-mcp/
├── src/
│   └── index.ts          # Main MCP server implementation
├── dist/                 # Compiled JavaScript (after build)
├── package.json          # Dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # This file

建筑

npm run build

清洁

npm run clean

错误处理

该服务器包括全面的错误处理功能，用于：

• GPS代码格式无效
• API连接失败
• 数据缺失或格式错误
• 利率限制考虑因素

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 彻底测试
5. 提交拉取请求

许可证

MIT许可证

支持

有关加纳邮政GPS地址的问题或疑问，请参阅加纳邮政官方文件或直接联系加纳邮政。