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 是否未被其他應用程序佔用。