ukagaka-doc-mcp
伺か（Ukagaka）の技術ドキュメントを検索する MCP サーバーです。
UKADOC・SSP ヘルプ・YAYA docs・里々 docs・蒼空 Wiki・湊 docs・Pasta docs・華和梨 docs のスナップショットを同梱しており、stdio モード（デフォルト）ではランタイムで外部ネットワークにアクセスしません。
使い方
npx（インストール不要）
npx ukagaka-doc-mcp
グローバルインストール
npm install -g ukagaka-doc-mcp
ukagaka-doc-mcp
Claude Desktop への組み込み
~/Library/Application Support/Claude/claude_desktop_config.json に追加します。
npx を使う場合（推奨）：
{
"mcpServers": {
"ukagaka-doc": {
"command": "npx",
"args": ["ukagaka-doc-mcp"]
}
}
}
グローバルインストール済みの場合：
{
"mcpServers": {
"ukagaka-doc": {
"command": "ukagaka-doc-mcp"
}
}
}
HTTP モード
--http を付けると Streamable HTTP の MCP サーバーとして起動します（ステートレス・認証なし）。
npx ukagaka-doc-mcp --http # http://127.0.0.1:8951/mcp
npx ukagaka-doc-mcp --http --host 0.0.0.0 --port 9000 # listen 先を変更
- エンドポイントは
POST /mcpのみです。 - MCP 仕様 2026-07-28（リクエスト単位の
_metaエンベロープ）と、それ以前のinitializeハンドシェイク方式（2025-11-25 / 2025-06-18 / 2025-03-26 / 2024-11-05）の両方のクライアントを同じエンドポイントで受け付けます。2025 系以前のリクエストへの応答は従来どおりapplication/jsonです。stdio モードも同様に両方に対応します。 Host/Originヘッダの検証は行いません。外部に公開する場合は nginx 等のリバースプロキシの背後に置いてください。- 起動直後と 24 時間ごとに GitHub 上の最新
data/index.jsonを取得し、同梱版より新しければメモリ上で差し替えます（ファイルには書き込みません）。取得に失敗した場合は現在のインデックスのまま動作を続けます。
提供ツール
検索対象
data/index.json として同梱済みです。週1回 CI が自動更新します。
必要環境
- Node.js 22 以上
開発
npm install
npm run refresh:index # ドキュメントの取得とインデックス生成
npm run build
npm start
テスト：
npm test
メンテナンス（依存更新・脆弱性対応・手動リリース等）の手順は docs/maintenance.md を参照してください。
インデックスの自動更新フロー
毎週月曜（cron）または手動実行
↓ docs/ 配下の各サブモジュールを最新化
↓ data/index.json を再生成
↓ 変更があればパッチバージョンを上げて PR を自動作成
↓ CI 通過後に auto-merge
↓ npm publish・git tag・GitHub Release を自動作成
必要な設定
パッケージ内容
npm tarball に含まれるファイル：
dist/— コンパイル済み JSdata/index.json— ドキュメントスナップショットLICENSE/NOTICE.md/README.md/SPEC.md
src/・tests/・docs/（ドキュメントのサブモジュール）は含みません。
ライセンス
実装コードは MIT License（LICENSE 参照）。
同梱の data/index.json は UKADOC・SSP ヘルプ・YAYA docs・里々 docs・蒼空 Wiki・湊 docs・Pasta docs・華和梨 docs を元に生成した外部由来データです。MIT License での再ライセンスは行っていません。利用・再配布時は上流の権利関係を別途確認してください（NOTICE.md 参照）。
