ukagaka-doc-mcp 0.2.10 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  伺か(Ukagaka)の技術ドキュメントを検索する MCP サーバーです。
4
4
 
5
- UKADOC・YAYA Wiki・里々Wiki・蒼空 Wiki のスナップショットを同梱しており、**ランタイムで外部ネットワークにアクセスしません**。
5
+ UKADOC・YAYA Wiki・里々Wiki・蒼空 Wiki のスナップショットを同梱しており、stdio モード(デフォルト)では**ランタイムで外部ネットワークにアクセスしません**。
6
6
 
7
7
  ## 使い方
8
8
 
@@ -48,6 +48,25 @@ ukagaka-doc-mcp
48
48
  }
49
49
  ```
50
50
 
51
+ ## HTTP モード
52
+
53
+ `--http` を付けると Streamable HTTP の MCP サーバーとして起動します(ステートレス・認証なし)。
54
+
55
+ ```bash
56
+ npx ukagaka-doc-mcp --http # http://127.0.0.1:8951/mcp
57
+ npx ukagaka-doc-mcp --http --host 0.0.0.0 --port 9000 # listen 先を変更
58
+ ```
59
+
60
+ | オプション | 説明 | デフォルト |
61
+ |------------|------|------------|
62
+ | `--http` | HTTP モードで起動 | (なし=stdio) |
63
+ | `--host <host>` | listen するホスト | `127.0.0.1` |
64
+ | `--port <port>` | listen するポート | `8951` |
65
+
66
+ - エンドポイントは `POST /mcp` のみです。
67
+ - `Host` / `Origin` ヘッダの検証は行いません。外部に公開する場合は nginx 等のリバースプロキシの背後に置いてください。
68
+ - 起動直後と 24 時間ごとに [GitHub 上の最新 `data/index.json`](https://github.com/finelagusaz/ukagaka-doc-mcp/raw/refs/heads/main/data/index.json) を取得し、同梱版より新しければメモリ上で差し替えます(ファイルには書き込みません)。取得に失敗した場合は現在のインデックスのまま動作を続けます。
69
+
51
70
  ## 提供ツール
52
71
 
53
72
  | ツール | 説明 |
package/SPEC.md CHANGED
@@ -50,7 +50,7 @@
50
50
 
51
51
  ランタイムは以下を満たさなければならない。
52
52
 
53
- - 起動時ネットワーク通信ゼロであること
53
+ - stdio モード(デフォルト)では起動時ネットワーク通信ゼロであること
54
54
  - `data/index.json` の読み込みだけで起動できること
55
55
  - `generatedAt` が 7 日を超えて古い場合、警告を出すことが望ましい
56
56
  - `data/index.json` が存在しない場合、起動失敗すること