English Français العربية

io.github.qso-graph/sota-mcp

السجل الرسمي أخرى

Summits on the Air MCP server. Summit lookup, spots, alerts, nearby summits.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package sota-mcp
Claude Code 
claude mcp add sota-mcp -- uvx sota-mcp==0.4.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "sota-mcp": {
            "command": "uvx",
            "args": [
                "sota-mcp==0.4.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. sota-mcp
  2. Install
  3. Tools
  4. Quick Start
  5. Testing Without Network
  6. MCP Inspector
  7. Development
  8. License

sota-mcp

MCP server for Summits on the Air (SOTA) — live spots, activation alerts, summit info, and nearby summits through any MCP-compatible AI assistant.

Part of the QSO-Graph project. No authentication required — uses the public SOTA API exclusively.

Install

uvx sota-mcp            # run it; nothing to install

Tools

ToolDescription
sota_spotsCurrent and recent spots with time window and association/mode filters
sota_alertsUpcoming scheduled activation alerts
sota_summit_infoSummit details by SOTA reference code
sota_summits_nearFind summits near coordinates (geospatial search)
get_version_infoService version + upstream spec version (fleet identity attestation)

Quick Start

No credentials needed — just install and configure your MCP client.

Configure your MCP client

sota-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "sota": {
      "command": "uvx",
      "args": ["sota-mcp"]
    }
  }
}
Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "sota": {
      "command": "uvx",
      "args": ["sota-mcp"]
    }
  }
}
ChatGPT Desktop
{
  "mcpServers": {
    "sota": {
      "command": "uvx",
      "args": ["sota-mcp"]
    }
  }
}
Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "sota": {
      "command": "uvx",
      "args": ["sota-mcp"]
    }
  }
}
VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "sota": {
      "command": "uvx",
      "args": ["sota-mcp"]
    }
  }
}
Gemini CLI

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

{
  "mcpServers": {
    "sota": {
      "command": "uvx",
      "args": ["sota-mcp"]
    }
  }
}
Ask questions

"What SOTA spots are active right now?"

"Tell me about summit W7I/SI-001"

"What summits are near Boise, Idaho?"

"Any SOTA alerts for this weekend?"

Testing Without Network

For testing all tools without hitting the SOTA APIs:

SOTA_MCP_MOCK=1 sota-mcp

MCP Inspector

sota-mcp --transport streamable-http --port 8007

Then open the MCP Inspector at http://localhost:8007.

Development

git clone https://github.com/qso-graph/sota-mcp.git
cd sota-mcp
uv sync --group dev
uv run pytest

License

GPL-3.0-or-later

الأسئلة الشائعة

ما هو io.github.qso-graph/sota-mcp؟

Summits on the Air MCP server. Summit lookup, spots, alerts, nearby summits.

كيف أثبّت io.github.qso-graph/sota-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add sota-mcp -- uvx sota-mcp==0.4.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.qso-graph/sota-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.qso-graph/sota-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص GPL-3.0.

من يصون io.github.qso-graph/sota-mcp؟

ينشره qso-graph. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.