onecall-mcp

AIエージェント向けツールとして、本番環境でテスト済みの認証不要な公開APIを10件公開する MCP (Model Context Protocol) サーバー。

onecall をベースに構築。APIキー不要。Python標準ライブラリのみ。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

なぜこれが存在するのか

ほとんどのAIエージェントは、天気、為替、暗号通貨、ジオコーディング、時刻、国、ニュースの参照を呼び出す必要があります。そのデータはオープンウェブ上に無料で存在します。しかしエージェントが必要とするのはURLではなくツールです。このサーバーは、MCP互換のクライアント（Claude Desktop、Cursor、Windsurf、Cline、OpenAI Codex CLI など）すべてに、10個すべてを1つのプロセスで提供します。

Related MCP server: tes-mcp-server

インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します:

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

Cursor

Settings → Features → Model Context Protocol → 新しいグローバルMCPサーバーを追加。同じ command/args を使用します。

Windsurf / Cline / その他

同じ構成です — command はPythonインタープリタ、args は onecall_mcp_server.py の絶対パスです。

検証

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

最終実行: 10/10 PASS (2026-08-26)。Initialize、tools/list、tools/call はすべて、ライブAPIデータとともに正しいJSON-RPC 2.0を返します。

アーキテクチャ

• 標準ライブラリのみ。 mcp パッケージへの依存なし、requests なし、SDKなし。urllib + json + asyncio のみ。

• stdio JSON-RPC 2.0。 MCP仕様 2024-11-05 に準拠。

• onecall の _lib/http.py を再利用し、リトライ、URLエンコーディング、統一エンベロープを実現。

• --demo フラグ は、ツールカタログを出力し、ライブ呼び出しを1回実行します。健全性チェックに便利です。

スモークテスト結果 (2026-08-26)

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

プロトコルハンドシェイク、機能ネゴシエーション、ツール発見、ツール呼び出し、ライブAPIレスポンスを網羅する10のアサーション。

ロードマップ

• 残りの4つの onecall ラッパーを追加（sunrise、catfact、cataas、nager holidays）

• HTTPトランスポート（現在はstdioのみ）

• 呼び出しごとの使用状況トラッキング + x402 ステーブルコインペイウォール統合

• glama.ai、smithery.ai、mcpmarket.com、mcpservers.org への掲載

ライセンス

MIT。