Sota Mcp

sota-mcp

用于 Summits on the Air (SOTA) 的 MCP 服务，可通过任何兼容 MCP 的 AI 助手获取实时电台报告、激活提醒、山峰信息和附近的山峰。

这是 QSO-Graph 项目的一部分。无需身份验证——仅使用公开的 SOTA API。

安装

uvx sota-mcp            # run it; nothing to install

工具

工具	描述
sota_spots	当前和近期的电台报告，支持时间范围以及协会／模式筛选
sota_alerts	即将进行的预定激活提醒
sota_summit_info	根据 SOTA 参考代码查询山峰详情
sota_summits_near	查找坐标附近的山峰（地理空间搜索）
get_version_info	服务版本 + 上游规范版本（集群身份验证）

快速开始

无需凭据——只需安装并配置 MCP 客户端。

配置 MCP 客户端

sota-mcp 适用于任何兼容 MCP 的客户端。添加服务配置并重启，工具便会自动显示。

Claude Desktop

将以下内容添加到 claude_desktop_config.json（macOS 上位于 ~/Library/Application Support/Claude/，Windows 上位于 %APPDATA%\Claude\）：

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

Claude Code

添加到 .claude/settings.json：

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

ChatGPT Desktop

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

Cursor

添加到 .cursor/mcp.json（项目级）或 ~/.cursor/mcp.json（全局）：

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

VS Code / GitHub Copilot

添加到工作区中的 .vscode/mcp.json：

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

Gemini CLI

添加到 ~/.gemini/settings.json（全局）或 .gemini/settings.json（项目级）：

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

提出问题

“现在有哪些 SOTA 电台报告处于活动状态？”

“介绍一下 W7I/SI-001 山峰”

“爱达荷州博伊西附近有哪些山峰？”

“这个周末有 SOTA 提醒吗？”

无网络测试

如需在不调用 SOTA API 的情况下测试所有工具：

SOTA_MCP_MOCK=1 sota-mcp

MCP Inspector

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

然后在 http://localhost:8007 打开 MCP Inspector。

开发

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

许可证

GPL-3.0-or-later