location-mcp-server

location-mcp-server

1
location_services

The Location MCP Server is a Model Context Protocol server that provides location data from a macOS application by integrating with Claude Desktop. It facilitates interaction by exposing a 'getCurrentLocation' tool that retrieves data from the local app.

Location MCP Server

An MCP (Model Context Protocol) server that provides location data from a local macOS app.

Prerequisites

  • macOS (this package launches a macOS app)
  • Node.js 16 or higher

Installation

Use npm install -g @sokyran/location-mcp-server or run directly with npx @sokyran/location-mcp-server.

Usage with Claude Desktop

  1. Download and place location-getter-agent.app in the same directory.
  2. Edit the Claude Desktop configuration file to add the MCP server command and arguments.
  3. Restart Claude Desktop and use the getCurrentLocation tool.

How It Works

  • Launches location-getter-agent.app
  • Waits for the app's HTTP server to start on port 8080
  • Exposes a getCurrentLocation tool to Claude
  • Fetches and returns location data from the local app

Troubleshooting

  • Ensure location-getter-agent.app is in the correct directory
  • Allow necessary permissions in System Preferences
  • Ensure port 8080 is free

Instructions

  1. Use Xcode to build location-getter
  2. Find the app in Product -> Show build folder in Finder
  3. Move location-getter-agent.app next to index.ts
  4. Run npm commands to build and start the application.