HRSSC / ELM Reference MCP Server

MCP-сервер, предоставляющий доступ к двум независимо запрашиваемым, полностью офлайн-векторным базам данных для исследования трудовых отношений USPS/APWU:

• query_elm — USPS Employee and Labor Relations Manual (ELM) — разбит по собственной нумерации разделов (например, 511.43, 665.41).

• query_hrssc — Национальное соглашение APWU-HRSSC на 2024–2029 годы — разбито на фрагменты по статьям/разделам, с указанием страниц источника.

Оба — инструменты семантического поиска (на основе эмбеддингов). Они выдают релевантный текст с точными ссылками-цитатами, но не интерпретируют, применимо ли то или иное положение к конкретной ситуации: всегда сверяйте полученный текст с самим документом, прежде чем полагаться на него.

Что внутри

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

Исходные материалы: ELM, загруженный с официального сайта USPS (about.usps.com/manuals/elm/), версия от марта 2024 года. Соглашение HRSSC оцифровано из личного печатного экземпляра (пропущено через OCR, поэтому в точных формулировках возможен шум распознавания — для всего важного обязательно сверяйтесь с фактическим контрактом).

Related MCP server: agent-history-mcp

Установка

pip install -r requirements.txt

Использование с Claude Code / Claude Desktop

Добавьте в конфигурацию MCP (например, claude_desktop_config.json или .claude/mcp.json):

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

Затем просите Claude, например: «проверь в ELM стандарты по разумному приспособлению» или «что сказано соглашении HRSSC о некарьерных сотрудниках» — и Claude напрямую вызовет query_elm / query_hrssc.

Использование с ChatGPT / инструментами на стороне GPT

ChatGPT не понимает MCP нативно. Есть два практичных варианта:

1. Локальный скрипт, а не живой коннектор: запускайте внутренние запросы chromadb из src/server.py напрямую в Python-окружении (например, в сессии Code Interpreter с загруженной папкой data/) — точный запрос для копирования приведён в функциях query_elm / query_hrssc файла server.py.

2. Оберните его как HTTP API (в комплект не входит) и выставите как Custom GPT Action, если нужен живой доступ из размещённого GPT, а не разовая сессия Code Interpreter.

Автономный скрипт запроса

Для быстрого запроса в терминале вообще без обращения к 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'))
"

Оговорки

• Только выборка по документу, а не юридическая консультация. Прежде чем полагаться на результат в чём-либо важном, проверяйте цитаты по оригинала.

• Текст Соглашения HRSSC получен через OCR со сфотографированных на двух страниц; в отношении всего важного выборочно проверяйте точные формулировки.

• Ни одна из баз данных не покрывает основное Национальное соглашение APWU-USPS (это отдельный документ, не Тождественный соглашению по HRSSC) или справочник USPS (Reasonable accommodation) USPS (процедуры разумного приспособления) — сюда он не включён.