MCP Server TypeScript Starter
2025.04.03
0
JavaScript位置服务位置服务
mylocation-mcp 是一个基于 TypeScript 的 Model Context Protocol (MCP) 服务器实现，提供位置服务功能。它支持通过坐标或 IP 地址进行位置查询，并集成了 IPInfo.io API 来实现 IP 地址定位。该服务器还提供了健康检查端点，确保服务的可用性。
View on GitHub
Overview
基本能力
产品定位
mylocation-mcp 是一个位置服务 MCP 服务器，提供基于坐标和 IP 地址的位置查询功能。
核心功能
- TypeScript 配置：使用 TypeScript 开发，提供类型安全的开发环境。
- 完整的 MCP 服务器设置：支持 MCP 协议，提供标准化的服务接口。
- 位置服务实现：
- 基于坐标的位置查询
- 基于 IP 地址的位置查询（使用 IPInfo.io API）
- 健康检查端点
- 外部 API 集成：与 IPInfo.io API 集成，实现 IP 地址定位。
适用场景
- 需要基于坐标或 IP 地址查询位置的应用程序。
- 需要集成 MCP 协议的位置服务。
- 需要健康检查功能的服务监控。
工具列表
- get-location-by-coordinates：通过提供的坐标查询位置信息。
- get-location-by-ip：通过 IP 地址查询位置信息。
- health：检查服务的健康状态。
常见问题解答
- 如何获取 IPInfo.io API Token？：需要在 IPInfo.io 官网注册并获取 API Token。
- 如何配置环境变量？：创建
.env文件并添加IPINFO_TOKEN=your_ipinfo_token_here。
使用教程
使用依赖
- Node.js 环境
- npm 包管理器
安装教程
npm install mylocation-mcp
配置环境变量
- 创建
.env文件：
IPINFO_TOKEN=your_ipinfo_token_here
- 在代码中导入和使用：
import { McpServer } from 'mylocation-mcp';
开发模式
- 克隆仓库：
git clone https://github.com/yhwancha/mylocation-mcp.git
cd mylocation-mcp
- 安装依赖：
npm install
- 配置环境变量：
cp .env.example .env
# 编辑 .env 文件并添加 IPInfo.io API Token
- 构建项目：
npm run build
调试方式
- 启动服务：
npx mylocation-mcp-server
- 检查健康状态：
curl http://localhost:3000/health