Skip to main content
Glama
JJHerrmann

HRSSC / ELM Reference MCP Server

by JJHerrmann

HRSSC / ELM Reference MCP Server

Ein MCP-Server, der zwei unabhängig abfragbare, vollständig offline arbeitende Vektordatenbanken für die USPS/APWU-Forschung zu Arbeitsbeziehungen bereitstellt:

  • query_elm — das USPS Employee and Labor Relations Manual (ELM), segmentiert nach seiner eigenen Abschnittsnummerierung (z. B. 511.43, 665.41).

  • query_hrssc — das APWU-HRSSC National Agreement 2024–2029, segmentiert nach Artikel/Abschnitt, mit Quellseitenzahlen.

Beide sind semantische Abrufwerkzeuge (embedding-basiert). Sie liefern den relevanten Text mit exakten Zitaten; sie interpretieren nicht, ob eine Bestimmung auf eine bestimmte Situation zutrifft – überprüfen Sie den zurückgegebenen Text immer am tatsächlichen Dokument, bevor Sie sich darauf verlassen.

Was hier enthalten ist

data/
  ELM_vectordb/      Chroma DB, collection "elm"
  HRSSC_vectordb/     Chroma DB, collection "hrssc_agreement"
src/
  server.py           MCP server (FastMCP), two tools
requirements.txt

Quellenmaterial: ELM heruntergeladen von der offiziellen USPS-Website (about.usps.com/manuals/elm/), Ausgabe März 2024. Das HRSSC-Abkommen wurde aus einem persönlichen gedruckten Exemplar digitalisiert (per OCR erfasst; gelegentliche OCR-Fehler im genauen Wortlaut sind daher möglich – bestätigen Sie bei allem, was von Bedeutung ist, immer den tatsächlichen Vertragstext).

Related MCP server: agent-history-mcp

Einrichtung

pip install -r requirements.txt

Verwendung mit Claude Code / Claude Desktop

Fügen Sie Folgendes zu Ihrer MCP-Konfiguration hinzu (z. B. claude_desktop_config.json oder .claude/mcp.json):

{
  "mcpServers": {
    "hrssc-elm-reference": {
      "command": "python",
      "args": ["/absolute/path/to/hrssc-elm-mcp/src/server.py"]
    }
  }
}

Bitten Sie Claude dann z. B. darum, „die ELM auf Standards für angemessene Vorkehrungen zu prüfen“ oder „was sagt das HRSSC-Abkommen über nicht-karrierebeschäftigte Mitarbeiter“, und Claude ruft direkt query_elm / query_hrssc auf.

Verwendung mit ChatGPT / GPT-seitigen Tools

ChatGPT unterstützt MCP nicht nativ. Zwei praktische Optionen:

  1. Lokales Skript statt Live-Connector: Führen Sie die zugrunde liegenden chromadb-Abfragen von src/server.py direkt in einer Python-Umgebung aus (z. B. in einer Code-Interpreter-Sitzung mit hochgeladenem data/-Ordner) – die genauen Abfragemuster zum Kopieren finden Sie in den Funktionen query_elm / query_hrssc in server.py.

  2. Kapseln Sie es als HTTP-API (hier nicht enthalten) und stellen Sie es als Custom GPT Action bereit, wenn Sie von einem gehosteten GPT aus Live-Zugriff wünschen statt einer einmaligen Code-Interpreter-Sitzung.

Eigenständiges Abfrageskript

Für eine schnelle Terminalabfrage ganz ohne MCP:

python -c "
import sys
sys.path.insert(0, 'src')
from server import query_elm, query_hrssc
print(query_elm('your question here'))
print(query_hrssc('your question here'))
"

Einschränkungen

  • Nur Abruf, keine Rechtsberatung. Überprüfen Sie Zitate anhand der tatsächlichen Dokumente, bevor Sie sich bei irgendetwas von Bedeutung darauf verlassen.

  • Der Text des HRSSC-Abkommens wurde per OCR aus mit dem Telefon fotografierten Seiten erfasst; prüfen Sie den genauen Wortlaut bei allem, worauf es ankommt, stichprobenartig.

  • Keine der beiden Datenbanken umfasst das Hauptabkommen APWU-USPS National Agreement (ein separates Dokument neben dem HRSSC-spezifischen Abkommen) oder das USPS Handbook EL-307 (Verfahren für angemessene Vorkehrungen) – hier nicht enthalten.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    A
    maintenance
    Enables local semantic search over documents and code for Claude Code and Claude Desktop, running entirely offline with local embeddings and vector storage.
    14
    55 PyPI
    5
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables private, offline semantic search across local files (documents, images, videos) using OCR and vector search, and optionally performs web research with cited sources.
    AGPL 3.0
  • A
    license
    Not graded
    quality
    C
    maintenance
    Provides local, offline semantic search across 24 Russian Federation legal codes using natural-language queries, with tools to retrieve full articles by identifier and list available codes.
    BSD 2-Clause "Simplified"