onecall-mcp

Сервер MCP (Model Context Protocol), предоставляющий 10 проверенных в продакшене публичных API без авторизации в качестве инструментов для ИИ-агентов.

Построен на основе 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

Зачем это существует

Большинству ИИ-агентов нужны запросы погоды, FX, криптовалют, геокодирования, времени, стран и новостей. Данные есть в открытом вебе бесплатно. Но агенту нужны инструменты, а не URL. Этот сервер даёт любому MCP-совместимому клиенту (Claude Desktop, Cursor, Windsurf, Cline, OpenAI Codex CLI и т. д.) все 10 в одном процессе.

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

Настройки → Возможности → Model Context Protocol → Добавить новый глобальный MCP-сервер. Та же команда/аргументы.

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 — все возвращают корректный JSON-RPC 2.0 с живыми данными API.

Архитектура

• Только стандартная библиотека. Никакой зависимости от пакета mcp, ни requests, ни SDK. Просто urllib + json + asyncio.

• stdio JSON-RPC 2.0. Согласно спецификации MCP 2024-11-05.

• Переиспользует _lib/http.py из onecall для повторов, кодирования URL и единообразной обёртки.

• Флаг --demo выводит каталог инструментов и выполняет один живой вызов — полезно для быстрой проверки.

Результаты смоук-теста (2026-08-26)

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

10 проверок, покрывающих: рукопожатие протокола, согласование возможностей, обнаружение инструментов, вызов инструментов, ответ живого API.

Дорожная карта

• Добавить оставшиеся 4 обёртки onecall (sunrise, catfact, cataas, nager holidays)

• HTTP-транспорт (сейчас только stdio)

• Отслеживание использования по вызовам + интеграция платёжного барьера на стейблкоинах x402

• Листинг на glama.ai, smithery.ai, mcpmarket.com, mcpservers.org

Лицензия

MIT.