HRSSC / ELM Reference MCP Server

USPS/APWUの労使関係調査のための、独立してクエリ可能な完全オフラインのベクトルデータベースを2つ公開するMCPサーバーです：

• query_elm — USPS Employee and Labor Relations Manual（ELM）を、独自のセクション番号（例：511.43、665.41）ごとにチャンク化したもの。

• query_hrssc — 2024-2029 APWU-HRSSC National Agreementを、条項/セクションごとにチャンク化し、出典のページ番号付き。

どちらもセマンティック検索（埋め込みベース）の検索ツールです。関連するテキストを正確な引用付きで提示しますが、特定の状況に規定が適用されるかどうかの解釈は行いません。実際に利用する前に、返されたテキストを必ず実際のドキュメントで確認してください。

内容

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年3月版。HRSSC Agreementは個人所有の印刷コピーをデジタル化したもの（OCR処理済みのため、正確な文言には時折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"]
    }
  }
}

その後、「ELMで合理的配慮の基準を調べて」や「HRSSC協約は非キャリア従業員についてどう規定している？」のようにClaudeに質問すると、Claudeが query_elm / query_hrssc を直接呼び出します。

ChatGPT / GPT側ツールでの利用

ChatGPTはMCPをネイティブにはサポートしていません。実用的な選択肢は2つあります：

1. ローカルスクリプト（ライブコネクタではない）：src/server.py の基盤となる chromadb クエリをPython環境で直接実行します（例：data/ フォルダをアップロードしたCode Interpreterセッション）。コピーする正確なクエリパターンについては、server.py 内の query_elm / query_hrssc 関数を参照してください。

2. HTTP APIとしてラップする（本リポジトリには含まれません）。使い捨てのCode Interpreterセッションではなく、ホスト型GPTからライブアクセスしたい場合は、Custom GPT Actionとして公開します。

スタンドアロンのクエリスクリプト

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 Agreementのテキストは、スマートフォンで撮影したページに対してOCR処理を施したものです。重要事項の正確な文言は必ずスポットチェックしてください。

• どちらのDBも、主要なAPWU-USPS National Agreement（HRSSC固有の協約とは別の文書）やUSPS Handbook EL-307（合理的配慮の手続き）は対象外です。本リポジトリには含まれていません。