Połączenie
Serwer jest pod adresem https://geo.runningcat.dev/mcp i obsługuje Streamable HTTP. Przyjmuje ten sam klucz co API.
Claude Code
claude mcp add --transport http running-cat-geo https://geo.runningcat.dev/mcp \
--header "Authorization: Bearer YOUR_KEY"
Cursor
W pliku .cursor/mcp.json w projekcie albo ~/.cursor/mcp.json dla wszystkich projektów:
{
"mcpServers": {
"running-cat-geo": {
"url": "https://geo.runningcat.dev/mcp",
"headers": { "Authorization": "Bearer ${env:RUNNING_CAT_KEY}" }
}
}
}
Inni klienci
Działa każdy klient łączący się ze zdalnymi serwerami MCP przez HTTP, z podanym adresem i nagłówkiem Authorization: Bearer YOUR_KEY lub x-api-key. Klient, który przyjmuje tylko adres, może użyć https://geo.runningcat.dev/mcp?key=YOUR_KEY; zachowaj ten adres dla siebie, bo zawiera klucz.
Narzędzia
- point_report
- Wszystko o miejscu: nazwa i obszary, strefa czasowa, wysokość, pogoda, jakość powietrza, pobliskie stacje powietrza i wodowskazy rzek
- area_report
- Pogoda, jakość powietrza, wysokości, stacje powietrza i wodowskazy rzek w prostokącie, na siatce
- plan_route
- Trasa rowerowa, gravelowa, piesza lub samochodowa przez punkty pośrednie, z profilem, pogodą w czasie przyjazdu, strefami czasowymi i tym, co mija
- plan_loop
- Pętla o zadanej długości z punktu startowego, z przewyższeniem i nawierzchnią, opcjonalnie z tym samym raportem
- route_report
- Ten sam raport dla trasy, którą już masz jako GeoJSON, łącznie z nawierzchnią na całej długości
- stops_along_route
- Woda, jedzenie, sklepy, toalety, sklepy rowerowe i paliwo wzdłuż trasy, z kilometrami i długimi odcinkami bez żadnego z nich
- overpass_query
- Zapytanie Overpass QL do danych OpenStreetMap (co jest obsługiwane)
- weather_forecast
- Prognoza godzinowa na maksymalnie 14 dni
- air_quality
- Prognoza jakości powietrza i pyłków oraz to, co mierzą pobliskie stacje
- river_gauges
- Poziomy rzek w pobliżu punktu lub w prostokącie albo historia jednego wodowskazu
- elevation
- Wysokości do 1000 punktów
- where_is
- Kraj, region, miejscowość i strefa czasowa punktu
- outdoor_layers
- Znakowane szlaki, obszary chronione, trasy i wyciągi narciarskie oraz granice w prostokącie
Długie odpowiedzi, na przykład dwa tygodnie pogody godzinowej, są przycinane do kontekstu asystenta, a odpowiedź mówi, co przycięto. Pełne dane pobierzesz, wywołując bezpośrednio API.
O co pytać
- „Zaplanuj gravelową trasę z Monachium do Salzburga na sobotę, ze średnią 20 km/h. Gdzie zacznie padać i gdzie uzupełnię wodę?”
- „Czy Ren w Kolonii jest wyższy niż wczoraj i o ile?”
- „Czy powietrze w Pradze jest lepsze czy gorsze, niż mówiła prognoza? Porównaj stacje z prognozą.”
- „Znajdź piekarnie w granicach Wiednia, które otwierają się przed 7.”
Jak liczą się wywołania
Serwer nie dolicza własnych opłat. Wywołanie narzędzia liczy się jako żądania API, które wysyła: point_report i air_quality po jedno, raport dla obszaru lub trasy po jednym na część, trasa raz na każde rozpoczęte 100 km (50 km dla MTB). Limity planów są w sekcji cennika; plan darmowy daje 500 żądań dziennie.