mcpField
L
Location MCP Server

Location MCP Server

Local
github.com/sokyranMedia & Design2Updated 80w ago
Repository

About Location MCP Server

Location MCP Server is an MCP server that retrieves location data from a local macOS app. It is intended for MCP client users who want to request the current location through a tool.

Key features

  1. 01Launch the local location app
  2. 02Fetch location data over HTTP
  3. 03Provide the getCurrentLocation tool

Use cases

  1. 01Request current location in a Claude conversation
  2. 02Retrieve location data from the local macOS app

MCP support

It exposes the getCurrentLocation tool to MCP clients and returns location data fetched from the local app.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "location": {
      "command": "npx",
      "args": [
        "-y",
        "@sokyran/location-mcp-server"
      ]
    }
  }
}
Run commandnpx -y @sokyran/location-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@sokyran/location-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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"]
    }
  }
}

  1. Restart Claude Desktop.

  2. 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.