关键词

地理位置定位macOS本地应用工具ClaudeLLM

使用说明

项目简介

Location Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它通过启动并与本地 macOS 应用程序 'location-getter-agent.app' 交互，获取设备的地理位置信息，并以 MCP 工具的形式提供给大型语言模型 (LLM) 客户端，例如 Claude。

主要功能点

  • 提供地理位置工具: 向 LLM 客户端暴露 'getCurrentLocation' 工具，允许 LLM 获取当前设备的地理位置。
  • 本地应用集成: 依赖于独立的 macOS 应用程序 'location-getter-agent.app' 来实际获取位置数据，保证数据获取的本地化和隐私性。
  • MCP 协议支持: 遵循 MCP 协议标准，易于与支持 MCP 协议的 LLM 客户端集成。
  • 简单易用: 通过 npm 包进行安装和部署，配置简单，快速上手。

安装步骤

  1. 安装 npm 包: 在终端中运行以下命令全局安装 Location Server： 
    npm install -g @sokyran/location-mcp-server
    或者使用 npx 直接运行： 
    npx @sokyran/location-mcp-server
  2. 准备 location-getter-agent.app:
    • 根据仓库 'README.md' 的 "Instructions" 部分，使用 Xcode 构建 'location-getter' 项目。
    • 在 Xcode 中找到编译产物 'location-getter-agent.app'，将其复制到您运行 Location Server 命令的目录中（例如 'index.ts' 所在的目录）。

服务器配置

为了让 MCP 客户端（如 Claude Desktop）连接到 Location Server，您需要在客户端的配置文件中添加服务器配置信息。以下是 Claude Desktop 的配置示例：

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

配置项说明:

  • 'server name': 'location' (服务器名称，可以自定义)
  • 'command': 'npx' (启动命令，这里使用 npx 运行 npm 包)
  • 'args': '["@sokyran/location-mcp-server"]' (命令参数，指定要运行的 npm 包)

基本使用方法

  1. 启动服务器: 在终端中运行 'location-mcp-server' (如果全局安装) 或 'npx @sokyran/location-mcp-server' (如果使用 npx)。
  2. 配置 MCP 客户端: 按照上述 "服务器配置" 部分，配置您的 MCP 客户端 (如 Claude Desktop) 连接到 Location Server。
  3. 在 LLM 中使用工具: 在与 LLM 的对话中，您可以指示 LLM 使用 'getCurrentLocation' 工具来获取位置信息。例如，您可以询问 "我的当前位置在哪里？"，LLM 即可调用 'getCurrentLocation' 工具并利用 Location Server 获取位置信息并回答您。

信息

分类

桌面与硬件

访问项目