1. Conduid
  2. RAG
  3. io.github.qso-graph/adif-mcp
MCP server · RAG

io.github.qso-graph/adif-mcp

· github.com/qso-graph/adif-mcp

ADIF 3.1.6 parser and validator for amateur radio QSO logs. Full spec coverage.

Unclaimed rag
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.qso-graph/adif-mcp

io.github.qso-graph/adif-mcp is an MCP server in the RAG category: aDIF 3.1.6 parser and validator for amateur radio QSO logs. Full spec coverage.

Install

uvx
uvx adif-mcp
pip
pip install adif-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (4)

**Geospatial**`calculate_heading`

Parameters not published.

**Spec**`search_enumerations`

Parameters not published.

**System**`get_version_info`

Parameters not published.

**Validation**`parse_adif`

Parameters not published.

Ask AI

✦

Ask AI about io.github.qso-graph/adif-mcp

Powered by Claude · Grounded in docs

I know everything about io.github.qso-graph/adif-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

adif-mcp

Core Model Context Protocol (MCP) server for Amateur Radio Logging, built on the ADIF 3.1.6 specification.

Overview

adif-mcp gives AI agents safe, typed access to Amateur Radio logging data. It validates and parses ADIF records, searches the full ADIF 3.1.6 specification (fields, enumerations, data types), and provides geospatial utilities for Maidenhead locators.

Made with Python ADIF 3.1.6 PyPI CI Docs

Quick Start

pip install adif-mcp

Configure Your MCP Client

adif-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": {
    "adif": {
      "command": "adif-mcp"
    }
  }
}

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "adif": {
      "command": "adif-mcp"
    }
  }
}

ChatGPT Desktop

Configure via Settings > Apps & Connectors, or in your agent definition:

{
  "mcpServers": {
    "adif": {
      "command": "adif-mcp"
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "adif": {
      "command": "adif-mcp"
    }
  }
}

VS Code / GitHub Copilot

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

{
  "servers": {
    "adif": {
      "command": "adif-mcp"
    }
  }
}

Gemini CLI

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

{
  "mcpServers": {
    "adif": {
      "command": "adif-mcp"
    }
  }
}

Tools

adif-mcp exposes 8 tools via the Model Context Protocol:

Category Tool Description
Validation validate_adif_record Validate a raw ADIF string against the 3.1.6 spec
Validation parse_adif Streaming parser for large ADIF files with pagination
Spec read_specification_resource Retrieve raw JSON for any spec module (band, mode, fields)
Spec list_enumerations List all ADIF enumerations with entry counts
Spec search_enumerations Search enumeration records by keyword
Geospatial calculate_distance Great Circle distance (km) between two Maidenhead locators
Geospatial calculate_heading Initial beam heading (azimuth) between two locators
System get_version_info Active service version and ADIF spec version

Architecture

adif-mcp is the ADIF specification package -- validation, parsing, and geospatial tools. Credential management is handled by qso-graph-auth. Service integrations are separate MCP servers:

Package PyPI What It Does
qso-graph-auth v0.1.1 OS keyring credential management, persona CRUD
adif-mcp v1.0.5 ADIF 3.1.6 spec tools, validation, parsing, geospatial
eqsl-mcp v0.3.1 eQSL inbox, verification, AG status, last upload
qrz-mcp v0.3.1 Callsign lookup, DXCC, logbook status/fetch
lotw-mcp v0.3.1 LoTW confirmations, QSOs, DXCC credits, user activity
hamqth-mcp v0.4.0 Callsign lookup, DXCC, bio, activity, DX spots, RBN, QSO verify
pota-mcp v0.2.1 Parks on the Air spots, park info, stats, schedules
sota-mcp v0.1.5 Summits on the Air spots, alerts, summit info, stats
solar-mcp v0.2.0 Space weather conditions, forecasts, band outlook
wspr-mcp v0.3.1 WSPR beacon spots, propagation, band activity
iota-mcp v0.1.1 Islands on the Air lookup, search, nearby groups
n1mm-mcp v0.1.3 N1MM Logger+ contest state via UDP
ionis-mcp v1.2.8 HF propagation analytics (175M+ signatures)
qsp-mcp v0.2.1 Local LLM ↔ MCP tool relay

Authenticated servers use qso-graph-auth for persona lookup and keyring-backed credentials. Operators install only the servers they need. Each server is independently versioned with no unnecessary dependencies.

Compliance & Provenance

adif-mcp follows the ADIF Specification (currently 3.1.6) and uses registered Program IDs to identify all exports:

  • ADIF-MCP -- Core engine
  • ADIF-MCP-LOTW -- LoTW server
  • ADIF-MCP-EQSL -- eQSL server
  • ADIF-MCP-QRZ -- QRZ server

The project uses APP_ fields for provenance when augmenting records:

  • APP_ADIF-MCP_OP -- operation performed (normalize, validate, merge)
  • APP_ADIF-MCP-LOTW_ACTION -- LoTW server operation
  • APP_ADIF-MCP-EQSL_TIME -- timestamp of eQSL merge

License

GPL-3.0-or-later. See LICENSE for details.

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.qso-graph/adif-mcp

How do I install io.github.qso-graph/adif-mcp?

Run uvx adif-mcp, then add the server to your MCP client's configuration.

Is io.github.qso-graph/adif-mcp safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.qso-graph/adif-mcp still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.