@dennisk2025/iss-location-tracker
v1.0.0
Published
Provides the current geographic location (latitude and longitude) of the International Space Station (ISS) in real time.
Readme
ISS Location Tracker MCP Server
Provides the current geographic location (latitude and longitude) of the International Space Station (ISS) in real time as an MCP server and Claude Desktop tool.
Features
- One-click tool to fetch the ISS's current latitude and longitude
- Returns a JSON object with latitude, longitude, and timestamp
- Reliable, real time data (no API key required)
Installation
Using npm (installs globally for use as CLI):
npm install -g @dennisk2025/iss-location-trackerUsing npx (runs immediately, no install needed):
npx @dennisk2025/iss-location-trackerAdding to Claude Desktop
Add the following configuration to your Claude Desktop config file:
{
"mcpServers": {
"iss-location": {
"command": "npx",
"args": ["@dennisk2025/iss-location-tracker"]
}
}
}- On macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - On Windows:
%APPDATA%\Claude\claude_desktop_config.json
This will make the ISS location tool available in Claude Desktop.
Usage
Once configured, you can use this MCP server either via the CLI or as a Claude Desktop tool.
CLI
iss-location-tracker(This will run the MCP server on stdio)
Claude Desktop
- After Claude restarts, the
iss-locationtool will be available as a function/tool call.
Available Tools
1. get_current_iss_location
Fetches the current latitude and longitude of the International Space Station (ISS).
Parameters:
- None
Example Call:
{
"name": "get_current_iss_location",
"arguments": {}
}Example Output:
{
"latitude": 48.1501,
"longitude": 11.6012,
"timestamp": 1719609276
}Output Description
latitude: Current latitude of ISS (float)longitude: Current longitude of ISS (float)timestamp: UTC UNIX timestamp (int)
Error Handling
- If the external API fails, returns a clear error message.
- All exceptions and non-200 responses are handled gracefully.
Questions / Feedback
Open an issue or contact the maintainer for help or suggestions.
