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

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

Or run it directly with npx:

npx @sokyran/location-mcp-server

Usage with Claude Desktop

1. Download the location-getter-agent.app and place it in the same directory where you run the command.

2. Edit your Claude Desktop configuration file:

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

3. Restart Claude Desktop.

4. You can now use the getCurrentLocation tool in your conversations with Claude.

How It Works

The server:

1. Launches the location-getter-agent.app (which must be in the current directory)
2. Waits for the app to start its HTTP server on port 8080
3. Exposes a getCurrentLocation tool to Claude
4. When invoked, it fetches location data from the local app and returns it

Troubleshooting

• Make sure the location-getter-agent.app is in the same directory where you're running the command
• If you get permission errors, you may need to allow the app in System Preferences > Security & Privacy
• Check that port 8080 is not being used by another application

Instructions

1. Use Xcode, build location-getter
2. Inside Xcode, go to Product -> Show build folder in Finder
3. Here, find Products/Debug/location-getter-agent.app and paste in inside this folder, right near index.ts.
4. npm i, npm run build, npm run start