Location Mcp Server
What is Location Mcp Server
Location MCP Server is an MCP (Model Context Protocol) server that provides location data from a local macOS application.
Use cases
Use cases include enhancing chatbot interactions with real-time location information, developing location-aware applications, and integrating location services into macOS-based software.
How to use
To use the Location MCP Server, first install it via npm or run it directly with npx. Ensure the location-getter-agent.app is in the same directory, configure your Claude Desktop to recognize the MCP server, and restart Claude Desktop to access the getCurrentLocation tool.
Key features
Key features include the ability to fetch real-time location data from a local macOS app, integration with Claude Desktop, and a simple setup process using Node.js.
Where to use
Location MCP Server can be used in applications requiring location data, such as chatbots, location-based services, and any macOS applications that need to provide location context.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Location Mcp Server
Location MCP Server is an MCP (Model Context Protocol) server that provides location data from a local macOS application.
Use cases
Use cases include enhancing chatbot interactions with real-time location information, developing location-aware applications, and integrating location services into macOS-based software.
How to use
To use the Location MCP Server, first install it via npm or run it directly with npx. Ensure the location-getter-agent.app is in the same directory, configure your Claude Desktop to recognize the MCP server, and restart Claude Desktop to access the getCurrentLocation tool.
Key features
Key features include the ability to fetch real-time location data from a local macOS app, integration with Claude Desktop, and a simple setup process using Node.js.
Where to use
Location MCP Server can be used in applications requiring location data, such as chatbots, location-based services, and any macOS applications that need to provide location context.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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
-
Download the location-getter-agent.app and place it in the same directory where you run the command.
-
Edit your Claude Desktop configuration file:
{
"mcpServers": {
"location": {
"command": "npx",
"args": [
"@sokyran/location-mcp-server"
]
}
}
}-
Restart Claude Desktop.
-
You can now use the
getCurrentLocationtool in your conversations with Claude.
How It Works
The server:
- Launches the location-getter-agent.app (which must be in the current directory)
- Waits for the app to start its HTTP server on port 8080
- Exposes a
getCurrentLocationtool to Claude - 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
- Use Xcode, build location-getter
- Inside Xcode, go to Product -> Show build folder in Finder
- Here, find Products/Debug/location-getter-agent.app and paste in inside this folder, right near index.ts.
- npm i, npm run build, npm run start
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
