local-docs-mcp

ローカルフォルダ内のドキュメントを検索・閲覧して、質問への回答を探せる MCP サーバ。

機能

DOCS_ROOT に指定したフォルダ配下の docx / pptx / xlsx / pdf / md / txt / csv / html を対象に:

ツール	内容
list_documents	ドキュメント一覧(相対パス・サイズ・更新日時)
search_documents	全文検索。スペース区切りでAND検索。マッチ箇所の抜粋付きで返す
read_document	本文をテキスト(Markdown)として読み出し。大きい文書は offset で分割読み

回答の組み立てはMCPクライアント(Claude)側が行う。サーバは検索と本文抽出のみを担当する。 Office系ファイルは markitdown でテキスト変換し、 抽出結果はファイル更新日時ベースでキャッシュする。

セットアップ

uv が必要。依存関係は初回実行時に自動で解決される。

DOCS_ROOT=/path/to/documents uv run server.py
# エラーなく起動して待機すればOK (Ctrl+C で終了)

テスト用ドキュメント

test_docs/ に、動作確認用のサンプル文書一式が入っている(架空の会社「株式会社サンプル商事」の社内文書。対応フォーマットを網羅)。

test_docs/
├── 規程/
│   ├── 経費精算規程.docx       # 締め日は毎月5日、支払日は当月25日
│   ├── 出張旅費規程.pdf        # 日当2,500円、宿泊上限12,000円
│   └── 在宅勤務ガイドライン.md  # 週3日上限、在宅手当 月3,000円
├── 総務/
│   ├── 有給休暇FAQ.txt         # 入社6か月で10日付与、繰越は翌年度まで
│   ├── 社内連絡先一覧.xlsx      # 部署・担当・内線・メールの表
│   └── 備品購入申請ルール.csv   # 金額別の承認者(10万円以上は稟議書)
├── 議事録/
│   └── 2026-07-01_全社定例会議事録.md  # システム切替日、夏季休業日程
└── 資料/
    └── 新製品発表会企画.pptx    # 日程・会場・予算上限500万円

各ファイルには答え合わせ可能な事実を仕込んであるので、DOCS_ROOT をこのフォルダに向けて 「経費精算の締め日はいつ?」「出張の宿泊費の上限は?」「経理部の内線番号は?」などと質問すれば、 検索 → 本文読解 → 回答の一連の流れをテストできる。

DOCS_ROOT=$(pwd)/test_docs uv run server.py

Claude Code への登録

claude mcp add local-docs \
  -e DOCS_ROOT=/path/to/documents \
  -- uv --directory /path/to/this/repo run server.py

登録後、Claude Code で「◯◯について規程ではどうなってる?」のように聞くと、 検索 → 該当文書の読解 → 回答、が自動で行われる。