Skip to content

MCP Doc Search

Elasticsearch ベースの土木技術文書検索 MCP サーバー。

概要

  • プロトコル: Model Context Protocol (MCP) — FastMCP
  • 検索エンジン: Elasticsearch (RRF ハイブリッド検索: テキスト + セマンティック)
  • 認証: OAuth 2.1 + AWS Cognito
  • デプロイ: AWS App Runner (CDK)

対応コレクション

コレクション 検索ツール名
東京メトロ 土木文書 search_docs_metro
NEXCO 文書 search_docs_ne
鉄道基準・技術文書 search_docs_r_std
法令文書 search_docs_law
労災事例 get_workplace_accident_case
JR 東海 文書 search_docs_jr_tokai
公共事業評価 (PPE) ガイドライン search_ppe_guidelines
公共事業評価カルテ search_docs_ppe_karte

各コレクションに対応する get_document_details* ツールあり。

設定

2段構成:

  • .env — ES ホスト、API キー、MCP サーバー設定
  • config.yaml — インデックス定義、有効/無効フラグ、検索パラメータ
# config.yaml の例
indices:
  metro:
    enabled: true
    index_name: metro-docs
    api_key_env: ES_API_KEY_METRO

セットアップ

uv sync
cp .env.example .env           # ES ホスト・API キーを設定
uv run mcp-doc-srch             # MCP サーバー起動

リポジトリ

mcp-doc-srch/