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 에이전트는 날씨, 외환(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 서버 추가. 동일한 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 플래그는 도구 카탈로그를 출력하고 실제 호출을 한 번 실행하므로, 정상 동작 확인에 유용합니다.

스모크 테스트 결과 (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.