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