MCP 服务器 TypeScript 启动项目

这是一个基于模型上下文协议（MCP）的位置服务服务器实现。它展示了如何使用TypeScript构建一个MCP服务器，并提供通过坐标或IP地址进行位置查询的实际功能。

特性

• TypeScript配置
• 完整的MCP服务器设置
• 位置服务实现
  • 基于坐标的地理位置查找
  • 基于IP的位置查找（使用IPInfo.io）
  • 健康检查端点
• 类型安全的开发环境
• 外部API集成

安装

npm install mylocation-mcp

使用方法

1. 创建一个.env文件，并添加您的IPInfo.io API令牌：

IPINFO_TOKEN=your_ipinfo_token_here

2. 在代码中导入并使用：

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令牌

# 构建项目
npm run build

项目结构

.
├── src/
│   └── index.ts    # 主服务器实现文件，包含位置工具
├── build/           # 编译后的JavaScript文件
├── package.json    # 项目依赖和脚本
├── tsconfig.json   # TypeScript配置
├── .env.example    # 环境变量模板
└── README.md      # 文档

已实现的工具

1. 通过坐标获取位置

server.tool(
  "get-location-by-coordinates",
  "从提供的坐标获取地理位置信息",
  {
    latitude: z.string().describe("纬度坐标（-90到90之间）"),
    longitude: z.string().describe("经度坐标（-180到180之间）")
  },
  async ({ latitude, longitude }) => {
    // 实现细节...
  }
);

2. 通过IP获取位置

server.tool(
  "get-location-by-ip",
  "从IP地址获取地理位置信息",
  {
    ipAddress: z.string().describe("要查询的IP地址")
  },
  async ({ ipAddress }) => {
    // 实现细节...
  }
);

3. 健康检查

server.tool(
  "health",
  "检查服务的健康状态",
  {},
  async () => {
    // 实现细节...
  }
);

MCP 服务器配置

要在您的项目中使用此MCP服务器，请添加以下配置：

{
    "mcpServers": {
        "location-service": {
            "command": "npx",
            "args": [
              "-y",
              "mylocation-mcp-server"
            ],
            "env": {
              "IPINFO_TOKEN": <IPINFO_TOKEN>
            }
        }
    }
}

响应格式

所有工具返回的响应都遵循以下JSON结构：

{
  "code": number,
  "data": object | null,
  "message": string
}

• code: 响应状态码（整数）
• data: 数据对象或null
• message: 响应消息（字符串）

依赖

• express: 简单高效的Web服务器框架。
• cors: 允许跨域请求的中间件。
• 配置项: 提供环境变量管理功能。

许可证

MIT License

通过这个项目，您可以轻松地将地理位置服务集成到您的应用中，并利用其强大的功能进行位置相关操作。