Servidor MCP de Referencia HRSSC / ELM

Un servidor MCP que expone dos bases de datos vectoriales totalmente offline y consultables de forma independiente para la investigación de relaciones laborales USPS/APWU:

• query_elm — el Manual de Empleados y Relaciones Laborales (ELM) de USPS, dividido en fragmentos según su propia numeración de secciones (p. ej. 511.43, 665.41).

• query_hrssc — el Acuerdo Nacional APWU-HRSSC 2024-2029, dividido en fragmentos por Artículo/Sección, con números de página de origen.

Ambos son herramientas de recuperación por búsqueda semántica (basada en embeddings). Muestran el texto relevante con citas exactas; no interpretan si una disposición se aplica a una situación específica: verifique siempre el texto devuelto contra el documento real antes de confiar en él.

Qué contiene

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

Material de origen: ELM descargado del sitio oficial de USPS (about.usps.com/manuals/elm/), edición de marzo de 2024. Acuerdo HRSSC digitalizado a partir de una copia impresa personal (OCR, por lo que puede haber ruido ocasional de OCR en la redacción exacta; confirme siempre contra el contrato real para cualquier asunto de importancia).

Related MCP server: agent-history-mcp

Configuración

pip install -r requirements.txt

Uso con Claude Code / Claude Desktop

Añada a su configuración de MCP (p. ej. claude_desktop_config.json o .claude/mcp.json):

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

Luego pregunte a Claude cosas como "consulta el ELM sobre estándares de adaptación razonable" o "¿qué dice el acuerdo HRSSC sobre empleados no carrera?" y llamará directamente a query_elm / query_hrssc.

Uso con ChatGPT / herramientas del lado GPT

ChatGPT no habla MCP de forma nativa. Dos opciones prácticas:

1. Script local, no un conector en vivo: ejecute las consultas chromadb subyacentes de src/server.py directamente en un entorno Python (p. ej. una sesión de Code Interpreter con la carpeta data/ subida) — consulte las funciones query_elm / query_hrssc en server.py para el patrón de consulta exacto a copiar.

2. Envuélvalo como una API HTTP (no incluida aquí) y expóngalo como una Acción GPT personalizada, si desea acceso en vivo desde un GPT alojado en lugar de una sesión única de Code Interpreter.

Script de consulta independiente

Para una búsqueda rápida desde la terminal sin pasar por 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'))
"

Advertencias

• Solo recuperación, no asesoramiento legal. Verifique las citas contra los documentos reales antes de confiar en ellas para cualquier asunto de importancia.

• El texto del Acuerdo HRSSC pasó por OCR de páginas fotografiadas con el teléfono; verifique la redacción exacta en cualquier cosa que importe.

• Ninguna de las dos bases de datos cubre el Acuerdo Nacional principal APWU-USPS (un documento separado del acuerdo específico de HRSSC) ni el Manual EL-307 de USPS (procedimientos de Adaptación Razonable) — no incluidos aquí.