onecall-mcp

Ein MCP-Server (Model Context Protocol), der 10 produktionserprobte öffentliche APIs ohne Authentifizierung als Tools für KI-Agenten bereitstellt.

Basierend auf onecall. Keine API-Schlüssel. Python-Standardbibliothek. MIT.

weather_current(location)              # wttr.in
weather_forecast(lat, lon, days)       # open-meteo
fx_convert(amount, from, to)           # frankfurter (ECB)
fx_rates(base, symbols)                # frankfurter
crypto_price(ids, vs_currency)         # coingecko
geocode(query, limit)                  # openstreetmap nominatim
country_info(query)                    # REST Countries
time_in_zone(timezone)                 # timeapi.io
hn_front()                             # Hacker News top 10
hn_search(query, limit)                # Hacker News Algolia search

Warum es das gibt

Die meisten KI-Agenten müssen Wetter-, Devisen-, Krypto-, Geocoding-, Zeit-, Länder- und Nachrichtenabfragen durchführen. Die Daten sind frei im offenen Web verfügbar. Aber der Agent braucht Tools, keine URLs. Dieser Server stellt jedem MCP-kompatiblen Client (Claude Desktop, Cursor, Windsurf, Cline, OpenAI Codex CLI usw.) alle 10 in einem Prozess bereit.

Related MCP server: tes-mcp-server

Installation

Claude Desktop

Fügen Sie Folgendes zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "onecall": {
      "command": "python3",
      "args": ["/path/to/onecall-mcp/src/onecall_mcp_server.py"]
    }
  }
}

Cursor

Einstellungen → Features → Model Context Protocol → Neuen globalen MCP-Server hinzufügen. Gleicher Befehl/dieselben Argumente.

Windsurf / Cline / andere

Gleiche Struktur — command ist der Python-Interpreter, args ist der absolute Pfad zu onecall_mcp_server.py.

Verifizieren

# End-to-end JSON-RPC over stdio test
bash tests/mcp_stdio_smoke.sh

Letzter Durchlauf: 10/10 PASS (2026-08-26). Initialize, tools/list, tools/call liefern alle korrektes JSON-RPC 2.0 mit Live-API-Daten.

Architektur

• Nur Standardbibliothek. Keine Abhängigkeit vom mcp-Paket, kein requests, kein SDK. Nur urllib + json + asyncio.

• stdio JSON-RPC 2.0. Gemäß MCP-Spezifikation 2024-11-05.

• Verwendet das _lib/http.py von onecall für Wiederholungen, URL-Kodierung und einheitliches Envelope.

• --demo-Flag gibt den Tool-Katalog aus und führt einen Live-Aufruf aus, nützlich für Plausibilitätsprüfungen.

Smoke-Test-Belege (2026-08-26)

=== Passed: 10  Failed: 0 ===

10 Assertions, die Folgendes abdecken: Protokoll-Handshake, Fähigkeitsaushandlung, Tool-Erkennung, Tool-Aufruf, Live-API-Antwort.

Roadmap

• Die verbleibenden 4 onecall-Wrapper hinzufügen (sunrise, catfact, cataas, nager holidays)

• HTTP-Transport (derzeit nur stdio)

• Nutzungsverfolgung pro Aufruf + x402-Stablecoin-Paywall-Integration

• Auflistung auf glama.ai, smithery.ai, mcpmarket.com, mcpservers.org

Lizenz

MIT.