MCP Server TypeScript Starter 是一款面向开发者的地理位置查询 MCP Server,通过 IP 地址或经纬度坐标即可秒级反查出对应的地理位置信息(国家、城市、经纬度、时区等)。基于 TypeScript 构建,可轻松集成到各类应用中,让定位能力像调用本地函数一样简单。
它能做什么
- IP 反查地理位置:输入 IPv4/IPv6 地址,返回国家、地区、城市、邮编、时区等结构化信息。
- 坐标反查位置:给定经纬度坐标,反向解析出对应的地址描述与所属行政区划。
- 正向地理编码:根据地名或地址,返回对应的经纬度坐标。
- 批量查询支持:可在一次调用中处理多条 IP 或坐标记录,适合日志分析、风控、画像等场景。
是否需要密钥
取决于后端所采用的数据源(IP 库与地理编码服务)。自托管 MaxMind GeoLite2 等开源数据库时通常无需密钥;若接入 Google Maps、Mapbox、高德等商业地理服务,则需要申请并配置对应的 API Key。Starter 项目本身不内置任何凭据,开发者可根据需要自行替换数据源。
典型使用场景
- 为 Web/API 请求自动附加访问者所在城市与国家,用于本地化展示。
- 在日志与风控系统中将 IP 转为地理位置,辅助异常定位。
- 为地图、签到、附近的人等功能提供正向/反向地理编码能力。
