rokadoc-mcp-server 1.1.1

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yuma Shintani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,218 @@
+# rokadoc MCP Server
+
+NTTドコモビジネスが提供するRAGサービス「[rokadoc](https://rokadoc.ntt.com)」の機能を、Model Context Protocol (MCP) を介してAIアシスタントから利用可能にするサーバーです。
+
+VS Code、Kiro、Claude Desktop等のMCPクライアントから、ドキュメント変換やRAG検索をツールとして直接呼び出せます。
+
+## クイックスタート
+
+```bash
+ROKADOC_API_KEY=<your-api-key> npx rokadoc-mcp-server
+```
+
+Windows (PowerShell) の場合:
+
+```powershell
+$env:ROKADOC_API_KEY="<your-api-key>"; npx rokadoc-mcp-server
+```
+
+MCPサーバーは標準入出力（stdio）でMCPクライアントと通信します。通常は手動で起動せず、後述の「MCPクライアント設定例」のとおりクライアント側に登録してください。
+
+## バージョン指定
+
+| 指定方法                        | コマンド例                          | 説明                             |
+| ------------------------------- | ----------------------------------- | -------------------------------- |
+| 特定バージョン固定              | `npx rokadoc-mcp-server@1.0.7`      | `@<version>` で固定              |
+| 最新リリース                    | `npx rokadoc-mcp-server@latest`     | 常に最新版を取得                 |
+| メジャーバージョン追従 (`^`)    | `npx "rokadoc-mcp-server@^1.0.0"`   | v1系の最新（破壊的変更を除外）   |
+| マイナーバージョン追従 (`~`)    | `npx "rokadoc-mcp-server@~1.0.0"`   | v1.0系の最新（パッチ更新のみ）   |
+
+安定運用にはメジャーバージョン追従（`^1.0.0`）の利用を推奨します。破壊的変更はメジャーバージョンアップ時のみ行われます。範囲指定（`^` / `~`）はシェルが解釈しないよう引用符で囲んでください。
+
+## 前提条件
+
+- **Node.js**: `>=22`（`node --version` で確認できます）
+- **rokadoc API Key**: rokadocサービスへの認証に使用するAPIキー
+
+Node.jsのバージョンが不足している場合、インストール時に `EBADENGINE` の警告が出力されます。
+
+## 環境変数
+
+| 環境変数           | 必須   | デフォルト値                  | 説明                   |
+| ------------------ | ------ | ----------------------------- | ---------------------- |
+| `ROKADOC_API_KEY`  | はい   | -                             | rokadoc APIの認証キー  |
+| `ROKADOC_BASE_URL` | いいえ | `https://api.rokadoc.ntt.com` | rokadoc APIのベースURL |
+
+`ROKADOC_API_KEY` が未設定の場合、サーバーは標準エラー出力にエラーメッセージを出力して終了コード1で終了します。
+
+オンプレミス環境のrokadocインスタンスに接続する場合は `ROKADOC_BASE_URL` を設定してください。URLは `https://` で始まる必要があり、`http://` は自動的に `https://` に変換され、末尾のスラッシュは除去されます。
+
+## 提供ツール
+
+| ツール                  | 説明                               | 種別         |
+| ----------------------- | ---------------------------------- | ------------ |
+| `convert_document`      | ドキュメントを構造化テキストに変換 | 書き込み     |
+| `list_conversions`      | 変換ジョブ一覧を取得               | 読み取り専用 |
+| `get_conversion_result` | 変換結果を取得                     | 読み取り専用 |
+| `search_documents`      | RAG検索を実行                      | 読み取り専用 |
+
+全ツールで `space_id` または `space_name` によるスペース指定が可能です。
+
+各ツールはMCP仕様のアノテーションヒント（`readOnlyHint` / `destructiveHint` / `idempotentHint` / `openWorldHint`）を宣言しており、MCPクライアントが実行前にユーザーへ影響範囲を提示できます。いずれのツールも既存データの削除・上書きは行いません。詳細は[GitHubのREADME](https://github.com/yuma-shin/rokadoc-mcp-server#ツールアノテーション)を参照してください。
+
+## MCPクライアント設定例
+
+### VS Code / Kiro
+
+`.vscode/mcp.json` または `.kiro/settings/mcp.json` に以下をそのまま追加します。
+
+```json
+{
+  "inputs": [
+    {
+      "type": "promptString",
+      "id": "rokadoc-api-key",
+      "description": "rokadoc API Key",
+      "password": true
+    }
+  ],
+  "servers": {
+    "rokadoc": {
+      "command": "npx",
+      "args": ["-y", "rokadoc-mcp-server"],
+      "env": {
+        "ROKADOC_API_KEY": "${input:rokadoc-api-key}"
+      }
+    }
+  }
+}
+```
+
+バージョンを固定する場合は `args` を `["-y", "rokadoc-mcp-server@1.0.7"]` に置き換えてください。
+
+### Claude Desktop
+
+`claude_desktop_config.json` に以下をそのまま追加します（Claude Desktopは `mcpServers` キーを使用します）。
+
+```json
+{
+  "mcpServers": {
+    "rokadoc": {
+      "command": "npx",
+      "args": ["-y", "rokadoc-mcp-server"],
+      "env": {
+        "ROKADOC_API_KEY": "<your-api-key>"
+      }
+    }
+  }
+}
+```
+
+オンプレミス環境に接続する場合は `env` に `ROKADOC_BASE_URL` を追加します。
+
+```json
+{
+  "mcpServers": {
+    "rokadoc": {
+      "command": "npx",
+      "args": ["-y", "rokadoc-mcp-server"],
+      "env": {
+        "ROKADOC_API_KEY": "<your-api-key>",
+        "ROKADOC_BASE_URL": "https://rokadoc.your-company.com"
+      }
+    }
+  }
+}
+```
+
+`args` には必ず `-y` を含めてください。未インストール時に `npx` が確認プロンプトを表示すると、MCPのハンドシェイクが成立しません。
+
+## ファイルパスの扱い
+
+`convert_document` の `file_path` には、**ホストの絶対パスをそのまま**指定できます。パスの読み替えやボリュームマウントの設定は不要です。
+
+Windows の例:
+
+```
+C:\Users\username\Documents\report.pdf
+```
+
+macOS / Linux の例:
+
+```
+/Users/username/Documents/report.pdf
+```
+
+MCPサーバーはクライアントと同じホスト上のプロセスとして動作するため、ファイルシステムはそのまま見えます。
+
+## プロンプト例
+
+MCPクライアント設定後、AIアシスタントのチャットに以下のように入力するだけで各ツールが呼び出されます。
+
+### ドキュメントを変換する
+
+```
+C:\Users\username\Documents\提案書.pdf をrokadocで変換してください
+```
+
+スペースを指定する場合:
+
+```
+/Users/username/reports/月次報告.pdf を「営業部」スペースに変換してください
+```
+
+ページ範囲を指定する場合:
+
+```
+/Users/username/docs/仕様書.docx の1〜5ページを変換してください
+```
+
+### 変換ジョブの状態を確認する
+
+```
+rokadocの変換ジョブ一覧を確認してください
+```
+
+### 変換結果を取得する
+
+```
+変換が完了したジョブの結果を取得してください
+```
+
+### 社内ドキュメントを検索する
+
+```
+rokadocで「リモートワークの申請方法」について検索してください
+```
+
+タグで絞り込む場合:
+
+```
+タグ「人事」に絞って「有給休暇の取得条件」を検索してください
+```
+
+特定のスペースから検索する場合:
+
+```
+「総務部」スペースから「出張精算の手順」を検索してください
+```
+
+### ドキュメント登録から検索までの一連の流れ
+
+```
+1. /Users/username/docs/新入社員ガイド.pdf を変換してください
+2. ジョブの状態を確認してください
+3. 完了したら「入社手続きに必要な書類」について検索してください
+```
+
+## 対応ファイル形式
+
+PDF (.pdf), Word (.doc, .docx), Excel (.xls, .xlsx), PowerPoint (.ppt, .pptx)
+
+## ソースコード
+
+[GitHub](https://github.com/yuma-shin/rokadoc-mcp-server)
+
+## ライセンス
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 設定管理モジュール
+ *
+ * 環境変数からサーバー設定を読み込み、バリデーション・正規化を行う。
+ * バリデーション失敗時は標準エラー出力にメッセージを出力し process.exit(1) で終了する。
+ */
+import { ServerConfig } from "./types.js";
+/**
+ * 環境変数からサーバー設定を読み込み、検証・正規化して返す。
+ *
+ * - ROKADOC_API_KEY: 必須。未設定・空文字列・空白のみは拒否
+ * - ROKADOC_BASE_URL: 任意。未設定・空文字列の場合はデフォルト値を使用
+ *   - URL形式検証（http/https スキーム必須）
+ *   - 末尾スラッシュ除去、http→https自動変換
+ *
+ * @returns 正規化済みのサーバー設定
+ */
+export declare function loadConfig(): ServerConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM1C;;;;;;;;;GASG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAoCzC"}

package/dist/config.js

@@ -0,0 +1,49 @@
+/**
+ * 設定管理モジュール
+ *
+ * 環境変数からサーバー設定を読み込み、バリデーション・正規化を行う。
+ * バリデーション失敗時は標準エラー出力にメッセージを出力し process.exit(1) で終了する。
+ */
+import { normalizeBaseUrl, validateUrlFormat } from "./utils/url-validator.js";
+/** デフォルトのrokadoc API Base URL */
+const DEFAULT_BASE_URL = "https://api.rokadoc.ntt.com";
+/**
+ * 環境変数からサーバー設定を読み込み、検証・正規化して返す。
+ *
+ * - ROKADOC_API_KEY: 必須。未設定・空文字列・空白のみは拒否
+ * - ROKADOC_BASE_URL: 任意。未設定・空文字列の場合はデフォルト値を使用
+ *   - URL形式検証（http/https スキーム必須）
+ *   - 末尾スラッシュ除去、http→https自動変換
+ *
+ * @returns 正規化済みのサーバー設定
+ */
+export function loadConfig() {
+    // 1. ROKADOC_API_KEY の読み込みと検証
+    const apiKey = process.env.ROKADOC_API_KEY;
+    if (!apiKey || apiKey.trim() === "") {
+        process.stderr.write("[設定エラー] 環境変数 ROKADOC_API_KEY が設定されていないか、空白のみです。有効なAPIキーを設定してください。\n");
+        process.exit(1);
+    }
+    // 2. ROKADOC_BASE_URL の読み込みと検証
+    const rawBaseUrl = process.env.ROKADOC_BASE_URL;
+    let baseUrl;
+    if (!rawBaseUrl || rawBaseUrl.trim() === "") {
+        // 未設定または空文字列の場合はデフォルト値を使用
+        baseUrl = DEFAULT_BASE_URL;
+    }
+    else {
+        // URL形式検証
+        if (!validateUrlFormat(rawBaseUrl)) {
+            process.stderr.write(`[設定エラー] 環境変数 ROKADOC_BASE_URL の値が不正なURL形式です。"http://" または "https://" で始まるURLを指定してください。\n`);
+            process.exit(1);
+        }
+        // URL正規化（末尾スラッシュ除去、http→https変換）
+        baseUrl = normalizeBaseUrl(rawBaseUrl);
+    }
+    // 3. 正規化済み設定を返却
+    return {
+        baseUrl,
+        apiKey: apiKey.trim(),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,iCAAiC;AACjC,MAAM,gBAAgB,GAAG,6BAA6B,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU;IACxB,8BAA8B;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAE3C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qEAAqE,CACtE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,+BAA+B;IAC/B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAChD,IAAI,OAAe,CAAC;IAEpB,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,0BAA0B;QAC1B,OAAO,GAAG,gBAAgB,CAAC;IAC7B,CAAC;SAAM,CAAC;QACN,UAAU;QACV,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0FAA0F,CAC3F,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,iCAAiC;QACjC,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB;IAChB,OAAO;QACL,OAAO;QACP,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * rokadoc MCPサーバー エントリーポイント
+ *
+ * 設定読み込み、McpServerインスタンスの作成とツール登録、
+ * stdioトランスポート起動、シャットダウン処理を行う。
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+/**
+ * rokadoc MCPサーバー エントリーポイント
+ *
+ * 設定読み込み、McpServerインスタンスの作成とツール登録、
+ * stdioトランスポート起動、シャットダウン処理を行う。
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { RokadocApiClient } from "./services/rokadoc-client.js";
+import { createServer } from "./server.js";
+async function main() {
+    // 設定読み込みと検証（失敗時はプロセス終了）
+    const config = loadConfig();
+    // APIクライアント作成
+    const apiClient = new RokadocApiClient(config);
+    // MCPサーバーインスタンス作成（4つのツールを登録済み）
+    const server = createServer(apiClient);
+    // stdioトランスポートの作成とサーバー接続
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // グレースフルシャットダウン処理
+    const shutdown = async () => {
+        await server.close();
+        process.exit(0);
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+}
+main().catch((error) => {
+    process.stderr.write(`[起動エラー] MCPサーバーの起動に失敗しました: ${error}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,wBAAwB;IACxB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,cAAc;IACd,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE/C,+BAA+B;IAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAEvC,yBAAyB;IACzB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,kBAAkB;IAClB,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8BAA8B,KAAK,IAAI,CACxC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MCPサーバーのツール登録
+ *
+ * サーバー名・バージョンの定義と、4つのツール登録処理を提供する。
+ * index.ts とテストの両方から利用され、登録内容の重複定義を防ぐ。
+ *
+ * 各ツールには MCP 仕様の4つのアノテーションヒント
+ * （readOnlyHint / destructiveHint / idempotentHint / openWorldHint）を
+ * 明示的に指定し、ホストがユーザーに影響範囲を事前提示できるようにする。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RokadocApiClient } from "./services/rokadoc-client.js";
+/** MCPサーバー名 */
+export declare const SERVER_NAME = "rokadoc-mcp-server";
+/** MCPサーバーバージョン */
+export declare const SERVER_VERSION = "1.0.0";
+/**
+ * 4つのツールを MCPサーバーに登録する
+ *
+ * @param server - 登録先の McpServer インスタンス
+ * @param apiClient - rokadoc APIクライアント
+ */
+export declare function registerTools(server: McpServer, apiClient: RokadocApiClient): void;
+/**
+ * ツール登録済みの MCPサーバーインスタンスを生成する
+ *
+ * @param apiClient - rokadoc APIクライアント
+ * @returns 4つのツールが登録された McpServer
+ */
+export declare function createServer(apiClient: RokadocApiClient): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMhE,eAAe;AACf,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAEhD,mBAAmB;AACnB,eAAO,MAAM,cAAc,UAAU,CAAC;AA8BtC;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,gBAAgB,GAC1B,IAAI,CAwGN;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,gBAAgB,GAAG,SAAS,CASnE"}

package/dist/server.js

@@ -0,0 +1,149 @@
+/**
+ * MCPサーバーのツール登録
+ *
+ * サーバー名・バージョンの定義と、4つのツール登録処理を提供する。
+ * index.ts とテストの両方から利用され、登録内容の重複定義を防ぐ。
+ *
+ * 各ツールには MCP 仕様の4つのアノテーションヒント
+ * （readOnlyHint / destructiveHint / idempotentHint / openWorldHint）を
+ * 明示的に指定し、ホストがユーザーに影響範囲を事前提示できるようにする。
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { handleConvertDocument } from "./tools/convert-document.js";
+import { handleListConversions } from "./tools/list-conversions.js";
+import { handleGetConversionResult } from "./tools/get-conversion-result.js";
+import { handleSearchDocuments } from "./tools/search-documents.js";
+/** MCPサーバー名 */
+export const SERVER_NAME = "rokadoc-mcp-server";
+/** MCPサーバーバージョン */
+export const SERVER_VERSION = "1.0.0";
+/**
+ * スペース指定の共通パラメータ
+ *
+ * space_id が指定されている場合はそれを使用し、
+ * space_name のみが指定されている場合はスペース一覧APIでIDを解決する。
+ */
+const spaceParams = {
+    space_id: z.string().optional().describe("スペースID"),
+    space_name: z
+        .string()
+        .optional()
+        .describe("スペース名（space_id が指定されている場合は無視されます）"),
+};
+/**
+ * 読み取り専用ツール共通のアノテーション
+ *
+ * rokadoc APIに対してGETのみを行い、リモートの状態を変更しない。
+ * 同一入力での再実行は追加の副作用を持たない（べき等）。
+ * 外部サービス（rokadoc API）と通信するため openWorldHint は true。
+ */
+const READ_ONLY_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+/**
+ * 4つのツールを MCPサーバーに登録する
+ *
+ * @param server - 登録先の McpServer インスタンス
+ * @param apiClient - rokadoc APIクライアント
+ */
+export function registerTools(server, apiClient) {
+    // convert_document: 変換ジョブを新規作成するため書き込み系
+    // 既存データの削除・上書きは行わないため destructiveHint は false
+    // 呼び出しごとに新しい conversion_id が払い出されるため冪等ではない
+    server.registerTool("convert_document", {
+        title: "ドキュメント変換",
+        description: "ドキュメントファイルをrokadocに送信して構造化テキストに変換する",
+        inputSchema: {
+            file_path: z.string().min(1).describe("変換対象のファイルパス"),
+            from_page: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("開始ページ（正の整数）"),
+            to_page: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe("終了ページ（正の整数）"),
+            ...spaceParams,
+        },
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (args) => {
+        return handleConvertDocument(args, apiClient);
+    });
+    // list_conversions: ジョブ一覧をGETするのみ
+    server.registerTool("list_conversions", {
+        title: "変換ジョブ一覧",
+        description: "変換ジョブの一覧を取得する",
+        inputSchema: { ...spaceParams },
+        annotations: READ_ONLY_ANNOTATIONS,
+    }, async (args) => {
+        return handleListConversions(args, apiClient);
+    });
+    // get_conversion_result: 変換結果をGETするのみ
+    server.registerTool("get_conversion_result", {
+        title: "変換結果取得",
+        description: "指定された変換ジョブの結果を取得する",
+        inputSchema: {
+            conversion_id: z.string().min(1).describe("変換ジョブID"),
+            ...spaceParams,
+        },
+        annotations: READ_ONLY_ANNOTATIONS,
+    }, async (args) => {
+        return handleGetConversionResult(args, apiClient);
+    });
+    // search_documents: RAG検索をGETするのみ
+    server.registerTool("search_documents", {
+        title: "ドキュメント検索",
+        description: "rokadocに登録されたドキュメントに対してRAG検索を実行する",
+        inputSchema: {
+            query: z
+                .string()
+                .min(1)
+                .max(1000)
+                .describe("検索クエリ（1〜1000文字）"),
+            tags: z
+                .array(z.string())
+                .optional()
+                .describe("タグフィルタ（AND条件）"),
+            max_results: z
+                .number()
+                .int()
+                .positive()
+                .max(5)
+                .default(3)
+                .optional()
+                .describe("最大取得件数（デフォルト: 3、最大: 5）"),
+            ...spaceParams,
+        },
+        annotations: READ_ONLY_ANNOTATIONS,
+    }, async (args) => {
+        return handleSearchDocuments(args, apiClient);
+    });
+}
+/**
+ * ツール登録済みの MCPサーバーインスタンスを生成する
+ *
+ * @param apiClient - rokadoc APIクライアント
+ * @returns 4つのツールが登録された McpServer
+ */
+export function createServer(apiClient) {
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    registerTools(server, apiClient);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/services/rokadoc-client.d.ts

@@ -0,0 +1,97 @@
+/**
+ * rokadoc API HTTPクライアント
+ *
+ * rokadoc APIとの全通信を担当する。
+ * - 全リクエストに `api-key` ヘッダーを付与
+ * - 送信先をBase URLのホストのみに制限
+ * - 30秒タイムアウト設定（AbortController使用）
+ * - リトライロジック（5xx/ネットワークエラー: 最大3回、2秒間隔。4xxはリトライなし）
+ */
+import { ServerConfig, ConversionJob, SearchResult, GetConversionResultResponse, Space } from "../types.js";
+/** ページ範囲指定オプション */
+interface PageRange {
+    from_page?: number;
+    to_page?: number;
+    space_id?: string;
+}
+/** 検索オプション */
+interface SearchOptions {
+    tags?: string[];
+    max_results?: number;
+    tags_filter_include?: boolean;
+    space_id?: string;
+}
+/** 変換リクエストレスポンス */
+interface ConversionResponse {
+    code: number;
+    status: string;
+    conversion_id: string;
+}
+/**
+ * rokadoc APIクライアント
+ *
+ * コンストラクタで ServerConfig を受け取り、全APIメソッドで共通の
+ * ヘッダー付与・ホスト検証・タイムアウト・リトライ処理を適用する。
+ */
+export declare class RokadocApiClient {
+    private config;
+    constructor(config: ServerConfig);
+    /**
+     * 共通リクエストメソッド
+     *
+     * - ホスト検証: Base URLのホスト以外へのリクエストを拒否
+     * - api-key ヘッダー付与
+     * - 30秒タイムアウト（AbortController）
+     * - リトライ: 5xx/ネットワークエラーは最大3回・2秒間隔、4xxはリトライなし
+     */
+    private request;
+    /**
+     * ドキュメント変換リクエスト
+     *
+     * POST /v1/api/conversions (multipart/form-data)
+     *
+     * @param filePath - 変換対象のファイルパス
+     * @param options - ページ範囲指定（任意）
+     * @returns 変換ジョブIDとステータス
+     */
+    createConversion(filePath: string, options?: PageRange): Promise<ConversionResponse>;
+    /**
+     * 変換ジョブ一覧取得
+     *
+     * GET /v1/user/conversions
+     *
+     * @param spaceId - スペースID（任意）
+     * @returns 変換ジョブの配列
+     */
+    listConversions(spaceId?: string): Promise<ConversionJob[]>;
+    /**
+     * 変換結果取得
+     *
+     * GET /v1/user/conversions/{id}/document
+     *
+     * @param conversionId - 変換ジョブID
+     * @param spaceId - スペースID（任意）
+     * @returns 変換結果レスポンス（status, roka_response等を含む）
+     */
+    getConversionResult(conversionId: string, spaceId?: string): Promise<GetConversionResultResponse>;
+    /**
+     * ユーザーがアクセス可能なスペース一覧を取得
+     *
+     * GET /v1/user/spaces/join
+     *
+     * @returns スペース情報の配列（space_id, space_name）
+     */
+    listSpaces(): Promise<Space[]>;
+    /**
+     * RAGドキュメント検索
+     *
+     * GET /v1/api/search
+     *
+     * @param query - 検索クエリ（message パラメータとして送信）
+     * @param options - 検索オプション（タグフィルタ、最大件数、スペースID）
+     * @returns 検索結果の配列
+     */
+    searchDocuments(query: string, options?: SearchOptions): Promise<SearchResult[]>;
+}
+export {};
+//# sourceMappingURL=rokadoc-client.d.ts.map

package/dist/services/rokadoc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rokadoc-client.d.ts","sourceRoot":"","sources":["../../src/services/rokadoc-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EAGZ,2BAA2B,EAC3B,KAAK,EAGN,MAAM,aAAa,CAAC;AAGrB,mBAAmB;AACnB,UAAU,SAAS;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,cAAc;AACd,UAAU,aAAa;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,mBAAmB;AACnB,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAQD;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAe;IAE7B,YAAY,MAAM,EAAE,YAAY,EAE/B;IAED;;;;;;;OAOG;YACW,OAAO;IAsGrB;;;;;;;;OAQG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,SAAS,GAClB,OAAO,CAAC,kBAAkB,CAAC,CA2B7B;IAED;;;;;;;OAOG;IACG,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAWhE;IAED;;;;;;;;OAQG;IACG,mBAAmB,CACvB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,2BAA2B,CAAC,CAStC;IAED;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAQnC;IAED;;;;;;;;OAQG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;CACF"}