mcpField
L
Location MCP Server

Location MCP Server

本地服务
github.com/sokyran媒体与设计280 周前更新
代码仓库

关于 Location MCP Server

Location MCP Server 是从本地 macOS 应用获取位置数据的 MCP 服务，适用于希望通过工具查询当前位置的 MCP 客户端用户。

主要功能

  1. 01启动本地位置应用
  2. 02通过 HTTP 获取位置数据
  3. 03提供 getCurrentLocation 工具

适用场景

  1. 01在 Claude 对话中查询当前位置
  2. 02从本地 macOS 应用获取位置数据

MCP 相关

它向 MCP 客户端提供 getCurrentLocation 工具，并返回从本地应用获取的位置数据。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "location": {
      "command": "npx",
      "args": [
        "-y",
        "@sokyran/location-mcp-server"
      ]
    }
  }
}
启动命令npx -y @sokyran/location-mcp-server

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

安装包
npm@sokyran/location-mcp-server

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Location MCP 服务

一个 MCP（模型上下文协议）服务，可从本地 macOS 应用获取位置数据。

前提条件

  • macOS（此软件包会启动一个 macOS 应用）
  • Node.js 16 或更高版本

安装

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

也可以使用 npx 直接运行：

npx @sokyran/location-mcp-server

在 Claude Desktop 中使用

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

  2. 编辑 Claude Desktop 配置文件：

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

  1. 重启 Claude Desktop。

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

工作原理

此服务：

  1. 启动 location-getter-agent.app（该应用必须位于当前目录中）
  2. 等待应用在端口 8080 上启动 HTTP 服务
  3. 向 Claude 提供 getCurrentLocation 工具
  4. 调用该工具时，从本地应用获取位置数据并返回

故障排除

  • 确保 location-getter-agent.app 位于运行命令的同一目录中
  • 如果遇到权限错误，可能需要在“系统偏好设置”>“安全性与隐私”中允许该应用
  • 检查端口 8080 是否未被其他应用占用

说明

  1. 使用 Xcode 构建 location-getter
  2. 在 Xcode 中，前往 Product -> Show build folder in Finder
  3. 在这里找到 Products/Debug/location-getter-agent.app，并将其粘贴到此文件夹中，紧挨着 index.ts。
  4. 运行 npm i、npm run build、npm run start

评论

支持 Markdown

第一次接触 MCP？

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

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