mcpField
M
mcp-server-geodata-placefinder

mcp-server-geodata-placefinder

本地服务
github.com/fouomene地图与出行122 周前更新
代码仓库

关于 mcp-server-geodata-placefinder

mcp-server-geodata-placefinder 让 MCP 客户端访问 GeoData Placefinder 地理编码、Overture Maps 数据和 DuckDB。它适用于需要搜索地点、将坐标解析为地址，或查询附近及详细地点信息的助手。

主要功能

  1. 01按名称、地址或类别搜索地点
  2. 02反向地理编码坐标
  3. 03在指定半径内查找最近地点
  4. 04按 ID 获取 Overture Maps 地点记录
  5. 05检查 API 状态、版本和缓存大小

适用场景

  1. 01通过自然语言查询查找商家或地点
  2. 02确定给定坐标附近的地点
  3. 03按 ID 查询地点的完整记录

MCP 相关

向 MCP 客户端提供地点搜索、反向地理编码、最近地点查询、按 ID 获取地点和健康检查工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "fouomene-mcp-server-geodata-placefinder": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-geodata-placefinder"
      ]
    }
  }
}
启动命令npx -y mcp-server-geodata-placefinder

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmcp-server-geodata-placefinder2.0.0

工具

5

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

mcp-server-geodata-placefinder

一个 MCP (Model Context Protocol) 服务，让 AI 助手（Claude、Cursor、Zed 等）直接访问 GeoData Placefinder 地理编码 API、Overture Maps 数据和 DuckDB。 官方 MCP Registry

工具

工具描述
health_check检查 API 状态、版本和缓存大小
search_places按名称、地址、城市、邮政编码或类别进行地理编码
reverse_geocode将坐标转换为最近地点的名称和地址
find_nearest_place查找指定可配置半径内最近的地点
get_place_by_id根据 ID 获取地点的完整 Overture Maps 记录

快速开始

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "geodata-placefinder": {
      "command": "npx",
      "args": ["-y", "mcp-server-geodata-placefinder"]
    }
  }
}

配置文件位置：

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
Cursor

添加到 Cursor MCP 设置（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "geodata-placefinder": {
      "command": "npx",
      "args": ["-y", "mcp-server-geodata-placefinder"]
    }
  }
}
其他 MCP 客户端

任何兼容 MCP 的客户端都可以通过以下方式运行该服务：

npx mcp-server-geodata-placefinder

示例查询

连接后，你可以向 AI 助手提问：

  • “查找埃菲尔铁塔附近的咖啡店”
  • “坐标 48.8584, 2.2945 处是什么？”
  • “查找距离 40.7128, -74.0060 最近且位于 2km 范围内的医院”
  • “获取 overture:place:ac0aed88-e6cb-4224-9520-441339447760 的完整详情”

开发

# Clone the repository
git clone https://github.com/fouomene/geodataplacefinder.git
cd geodataplacefinder/mcp-server

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build
pnpm build

# Type-check
pnpm typecheck

许可证

GPL-3.0 — 参见 LICENSE。

链接

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。