Location MCP Server

🚀 位置 MCP 服务器

位置 MCP 服务器是一个 MCP（模型上下文协议）服务器，它能够提供来自本地 macOS 应用程序的位置数据，为相关应用场景提供了便捷的位置信息获取途径。

🚀 快速开始

位置 MCP 服务器可提供本地 macOS 应用程序的位置数据。使用前需满足一定的先决条件，并按照特定步骤完成安装，之后就能与 Claude Desktop 配合使用，获取位置信息。

✨ 主要特性

• 基于 MCP 协议，提供来自本地 macOS 应用程序的位置数据。
• 可与 Claude Desktop 集成，在对话中使用 getCurrentLocation 工具获取位置。

📦 安装指南

全局安装

npm install -g @sokyran/location-mcp-server

直接运行

npx @sokyran/location-mcp-server

💻 使用示例

与 Claude Desktop 配合使用

步骤 1：准备应用程序

下载 location-getter-agent.app 并将其放置在运行命令的同一目录中。

步骤 2：编辑配置文件

编辑您的 Claude Desktop 配置文件：

{
  "mcpServers": {
    "location": {
      "command": "npx",
      "args": ["@sokyran/location-mcp-server"]
    }
  }
}

步骤 3：重启应用

重新启动 Claude Desktop。

步骤 4：使用工具

您现在可以在与 Claude 的对话中使用 getCurrentLocation 工具。

本地构建与运行

步骤 1：构建应用

使用 Xcode，构建 location-getter。

步骤 2：找到应用程序

在 Xcode 中，转到“产品” -> “显示构建文件夹的 Finder”。

步骤 3：复制应用程序

在这里，找到 Products/Debug/location-getter-agent.app 并粘贴在 index.ts 所在的同一文件夹中。

步骤 4：安装依赖并启动

npm i
npm run build
npm run start

🔧 技术细节

服务器工作流程

1. 启动 location-getter-agent.app（必须位于当前目录）。
2. 等待应用程序在其 HTTP 服务器上运行在端口 8080。
3. 对外公开一个 getCurrentLocation 工具给 Claude。
4. 在被调用时，它从本地应用获取位置数据并返回。

📚 详细文档

故障排除

• 确保 location-getter-agent.app 位于运行命令的同一目录中。
• 如果出现权限错误，请在系统设置 > 安全与隐私中允许该应用程序。
• 检查端口 8080 是否未被其他应用程序占用。