@monoharada/wcf-mcp 0.9.0 → 0.9.1

package/data/custom-elements.json

@@ -42282,24 +42282,6 @@
                 }
               ]
             },
-            {
-              "kind": "method",
-              "name": "#isSlottedControlClick",
-              "privacy": "private",
-              "return": {
-                "type": {
-                  "text": "boolean"
-                }
-              },
-              "parameters": [
-                {
-                  "name": "path",
-                  "type": {
-                    "text": "readonly EventTarget[]"
-                  }
-                }
-              ]
-            },
             {
               "kind": "method",
               "name": "#isUsablePrimaryTitleLink",

package/data/design-tokens.json

@@ -1,6 +1,6 @@
 {
   "version": "0.2.0",
-  "extractedAt": "2026-03-03T05:48:06.856Z",
+  "extractedAt": "2026-03-07T09:50:20.226Z",
   "themes": {
     "default": "light",
     "available": [

package/data/guidelines-index.json

@@ -1,6 +1,6 @@
 {
   "version": "0.1.0",
-  "indexedAt": "2026-03-03T05:48:07.276Z",
+  "indexedAt": "2026-03-07T09:50:20.703Z",
   "documents": [
     {
       "id": ".claude/skills/css-writing-rules/references/core-principles.md",
@@ -4304,7 +4304,7 @@
             "両方指定時は"
           ],
           "snippet": "```typescript\n/** カスタムツール定義 */\ninterface WcfMcpPluginTool {\n  /** ツール名（必須。組み込みツール名と重複不可） */\n  name: string;\n  /** ツールの説明 */\n  description?: string;\n  /** 入力スキーマ（JSON Schema 形式） */\n  inputSchema?: Record<string, unknown>;\n  /** 動的ハンドラ関数。両方指定時は handler が優先される */\n  handler?: (args: Record<string, unknown>, context: WcfMcpHandlerContext) => unknown | Promise<unknown>;\n  /** 静的レスポンスペイロード。handler がある場合は無視される */\n  staticPayload?: unknown;\n}\n```\n\n### handler vs staticPayload\n\n- `handler`: リクエストごとに実行される関",
-          "body": "### handler vs staticPayload - `handler`: リクエストごとに実行される関数。動的な結果を返す場合に使用 - `staticPayload`: 固定のレスポンスを返す場合に使用 - **両方指定した場合**: `handler` が優先され、`staticPayload` は無視される - **どちらも未指定**: バリデーションエラー（少なくとも一方が必須）",
+          "body": "### handler vs staticPayload - `handler`: リクエストごとに実行される関数。動的な結果を返す場合に使用 - `staticPayload`: 固定のレスポンスを返す場合に使用 - **両方指定した場合**: `handler` が優先され、`staticPayload` は無視される - **どちらも未指定**: バリデーションエラー（少なくとも一方が必須） - `handler` は plain payload のほか raw MCP result（`{ content: [...] }`）を返してもよい - ただし最終返却サイズには 100KB 上限が適用され、上限を超える raw result は `TOOL_RESULT_TOO_LARGE` warning payload に置き換わる",
           "startLine": 25
         },
         {
@@ -4329,11 +4329,11 @@
             "filename",
             "promise",
             "unknown",
-            "ツール応答を"
+            "テキストデータファイルを読み込む"
           ],
-          "snippet": "```typescript\n/** handler 関数に渡されるコンテキスト */\ninterface WcfMcpHandlerContext {\n  /** プラグイン自身の情報 */\n  plugin: { name: string; version: string };\n  /** 共通ヘルパー */\n  helpers: {\n    /** JSON データファイルを読み込む */\n    loadJsonData: (fileName: string) => Promise<unknown>;\n    /** ツール応答を MCP 形式の JSON テキストに変換する */\n    buildJsonToolResponse: (payload: unknown) => { content: Array<{ type: string; text: string }> };\n    /** prefix を正規化する（デフォルト: \"dads\"） */\n    normalizePrefix: (prefix?: string) => string;\n    /** タグ名",
+          "snippet": "```typescript\n/** handler 関数に渡されるコンテキスト */\ninterface WcfMcpHandlerContext {\n  /** プラグイン自身の情報 */\n  plugin: { name: string; version: string };\n  /** 共通ヘルパー */\n  helpers: {\n    /** JSON データファイルを読み込む */\n    loadJsonData: (fileName: string) => Promise<unknown>;\n    /** テキストデータファイルを読み込む (v1.1+) */\n    loadTextData: (fileName: string) => Promise<string>;\n    /** ツール応答を MCP 形式の JSON テキストに変換する */\n    buildJsonToolResponse: (payload: unknown) => { content: Array<{ type: string; text: string }> };\n    /** ",
           "body": "",
-          "startLine": 50
+          "startLine": 52
         },
         {
           "heading": "DataSource オブジェクト",
@@ -4361,7 +4361,7 @@
           ],
           "snippet": "```typescript\n/** データソース差し替え定義 */\ninterface WcfMcpDataSourceConfig {\n  /** 差し替え対象のファイル名 */\n  fileName: string;\n  /** 差し替えファイルのパス */\n  path: string;\n}\n```\n\n### 差し替え可能なファイル\n\n| fileName | 説明 |\n|----------|------|\n| `custom-elements.json` | Custom Elements Manifest |\n| `install-registry.json` | インストールレジストリ |\n| `pattern-registry.json` | パターンレジストリ |\n| `design-tokens.json` | デザイントークン |\n| `guidelines-index.json` | ガイドラインインデックス |",
           "body": "### 差し替え可能なファイル | fileName | 説明 | |----------|------| | `custom-elements.json` | Custom Elements Manifest | | `install-registry.json` | インストールレジストリ | | `pattern-registry.json` | パターンレジストリ | | `design-tokens.json` | デザイントークン | | `guidelines-index.json` | ガイドラインインデックス |",
-          "startLine": 73
+          "startLine": 77
         },
         {
           "heading": "バリデーションルール",
@@ -4378,7 +4378,7 @@
           ],
           "snippet": "1. `name` と `version` は必須\n2. ツール名は組み込みツール名と重複不可\n3. 複数プラグイン間でツール名の重複不可\n4. `dataSources` のファイル名は上記5種のみ\n5. 複数プラグイン間で同一ファイルの重複差し替え不可",
           "body": "1. `name` と `version` は必須 2. ツール名は組み込みツール名と重複不可 3. 複数プラグイン間でツール名の重複不可 4. `dataSources` のファイル名は上記5種のみ 5. 複数プラグイン間で同一ファイルの重複差し替え不可",
-          "startLine": 95
+          "startLine": 99
         },
         {
           "heading": "互換性ポリシー",
@@ -4387,15 +4387,19 @@
             "契約バージョン",
             "plugin_contract_version",
             "定数で公開",
+            "helpers",
+            "loadtextdata",
+            "テキストファイルの読み込み",
+            "utf-8",
             "破壊的変更なし",
             "新フィールドは追加のみ",
             "既存フィールドの削除・型変更なし",
             "破壊的変更を含む可能性あり",
             "メジャーバージョンアップで通知"
           ],
-          "snippet": "- **契約バージョン**: `1.0.0`（`PLUGIN_CONTRACT_VERSION` 定数で公開）\n- **v1.x 内**: 破壊的変更なし。新フィールドは追加のみ（既存フィールドの削除・型変更なし）\n- **v2.0**: 破壊的変更を含む可能性あり。メジャーバージョンアップで通知",
-          "body": "- **契約バージョン**: `1.0.0`（`PLUGIN_CONTRACT_VERSION` 定数で公開） - **v1.x 内**: 破壊的変更なし。新フィールドは追加のみ（既存フィールドの削除・型変更なし） - **v2.0**: 破壊的変更を含む可能性あり。メジャーバージョンアップで通知",
-          "startLine": 103
+          "snippet": "- **契約バージョン**: `1.1.0`（`PLUGIN_CONTRACT_VERSION` 定数で公開）\n- **v1.1 追加**: `helpers.loadTextData` — テキストファイルの読み込み（UTF-8）\n- **v1.x 内**: 破壊的変更なし。新フィールドは追加のみ（既存フィールドの削除・型変更なし）\n- **v2.0**: 破壊的変更を含む可能性あり。メジャーバージョンアップで通知",
+          "body": "- **契約バージョン**: `1.1.0`（`PLUGIN_CONTRACT_VERSION` 定数で公開） - **v1.1 追加**: `helpers.loadTextData` — テキストファイルの読み込み（UTF-8） - **v1.x 内**: 破壊的変更なし。新フィールドは追加のみ（既存フィールドの削除・型変更なし） - **v2.0**: 破壊的変更を含む可能性あり。メジャーバージョンアップで通知",
+          "startLine": 107
         },
         {
           "heading": "@experimental 機能",
@@ -4410,7 +4414,7 @@
           ],
           "snippet": "以下は将来追加される可能性がありますが、まだ安定していません:\n\n- ライフサイクルフック（`onInit`, `onDestroy`）\n- プラグイン間依存の宣言",
           "body": "以下は将来追加される可能性がありますが、まだ安定していません: - ライフサイクルフック（`onInit`, `onDestroy`） - プラグイン間依存の宣言",
-          "startLine": 109
+          "startLine": 114
         },
         {
           "heading": "設定ファイルからの利用",
@@ -4438,7 +4442,7 @@
           ],
           "snippet": "```json\n{\n  \"plugins\": [\n    {\n      \"module\": \"./plugins/my-plugin.mjs\"\n    },\n    {\n      \"name\": \"static-tools\",\n      \"version\": \"1.0.0\",\n      \"staticTools\": [\n        { \"name\": \"my_tool\", \"payload\": { \"ok\": true } }\n      ]\n    }\n  ]\n}\n```\n\n### module プラグイン\n\nESM ファイルが `default export` でプラグインオブジェクトを返す:\n\n```javascript\n// plugins/my-plugin.mjs\nexport default {\n  name: 'my-plugin',\n  version: '1.0.0',\n  tools: [\n    {\n      name: 'my_custom_tool',\n      description: 'Custom tool from plugin',\n",
           "body": "### module プラグイン ESM ファイルが `default export` でプラグインオブジェクトを返す:",
-          "startLine": 116
+          "startLine": 121
         }
       ]
     },

package/data/llms-full.txt

@@ -5083,9 +5083,9 @@ Requires: `heading`, `fieldset`, `input-text`, `select`, `textarea`, `button`
   <form id="application-form-single">
     <dads-fieldset>
       <legend>申請情報</legend>
-      <dads-input-text name="name" required error error-text="氏名は必須です"></dads-input-text>
-      <dads-select name="type" required></dads-select>
-      <dads-textarea name="reason" required></dads-textarea>
+      <dads-input-text label="氏名" name="name" required error error-text="氏名は必須です"></dads-input-text>
+      <dads-select label="種別" name="type" required></dads-select>
+      <dads-textarea label="理由" name="reason" required></dads-textarea>
     </dads-fieldset>
     <dads-button type="submit">送信</dads-button>
   </form>
@@ -5105,7 +5105,7 @@ Requires: `heading`, `step-navigation`, `fieldset`, `input-text`, `button`
   <form id="application-form-step">
     <dads-fieldset>
       <legend>ステップ1: 申請者情報</legend>
-      <dads-input-text name="name" required error error-text="氏名は必須です"></dads-input-text>
+      <dads-input-text label="氏名" name="name" required error error-text="氏名は必須です"></dads-input-text>
     </dads-fieldset>
     <dads-button type="submit">次へ</dads-button>
   </form>
@@ -5184,9 +5184,9 @@ Requires: `device-mock`, `heading`, `fieldset`, `input-text`, `select`, `textare
       <form>
         <dads-fieldset>
           <legend>基本情報</legend>
-          <dads-input-text name="name" required></dads-input-text>
-          <dads-select name="type" required></dads-select>
-          <dads-textarea name="detail" required></dads-textarea>
+          <dads-input-text label="氏名" name="name" required></dads-input-text>
+          <dads-select label="種別" name="type" required></dads-select>
+          <dads-textarea label="詳細" name="detail" required></dads-textarea>
         </dads-fieldset>
         <dads-button type="submit">確認へ進む</dads-button>
       </form>

package/data/skills-registry.json

@@ -0,0 +1,345 @@
+{
+  "schemaVersion": 2,
+  "sourceOfTruth": ".claude/skills",
+  "clients": {
+    "codex": {
+      "description": "Codex local skills install destination (~/.codex/skills)"
+    },
+    "claude_code": {
+      "description": "Claude Code project-level skill references"
+    },
+    "cursor": {
+      "description": "Cursor project-level skill references"
+    }
+  },
+  "skills": [
+    {
+      "name": "component-design-study",
+      "path": ".claude/skills/component-design-study",
+      "entry": "SKILL.md",
+      "clients": [
+        "codex",
+        "claude_code",
+        "cursor"
+      ],
+      "status": "active",
+      "description": "Drive design studies for new web components with evidence-based variant selection.",
+      "tags": [
+        "spec",
+        "workflow"
+      ],
+      "version": "1.0.0",
+      "dependencies": [],
+      "compat": {
+        "minVersion": {
+          "claude_code": "1.0",
+          "cursor": "0.50",
+          "codex": "0.1"
+        },
+        "capabilities": [
+          "read_repo",
+          "web_fetch"
+        ]
+      },
+      "manifest": {
+        "author": "wcf-team",
+        "license": "MIT",
+        "entryFormat": "markdown",
+        "sections": [
+          "overview",
+          "workflow",
+          "do_dont",
+          "references"
+        ],
+        "sizeBytes": 30404,
+        "lastUpdated": "2026-03-04"
+      }
+    },
+    {
+      "name": "css-writing-rules",
+      "path": ".claude/skills/css-writing-rules",
+      "entry": "SKILL.md",
+      "clients": [
+        "codex",
+        "claude_code",
+        "cursor"
+      ],
+      "status": "active",
+      "description": "CSS coding guidelines for Web Components with Shadow DOM.",
+      "tags": [
+        "spec",
+        "token"
+      ],
+      "version": "1.0.0",
+      "dependencies": [],
+      "compat": {
+        "minVersion": {
+          "claude_code": "1.0",
+          "cursor": "0.50",
+          "codex": "0.1"
+        },
+        "capabilities": [
+          "read_repo"
+        ]
+      },
+      "manifest": {
+        "author": "wcf-team",
+        "license": "MIT",
+        "entryFormat": "markdown",
+        "sections": [
+          "overview",
+          "workflow",
+          "do_dont",
+          "references"
+        ],
+        "sizeBytes": 43328,
+        "lastUpdated": "2026-03-04"
+      }
+    },
+    {
+      "name": "headless-component-design",
+      "path": ".claude/skills/headless-component-design",
+      "entry": "SKILL.md",
+      "clients": [
+        "codex",
+        "claude_code",
+        "cursor"
+      ],
+      "status": "active",
+      "description": "Headless Web Component design patterns with DADS conventions.",
+      "tags": [
+        "spec"
+      ],
+      "version": "1.0.0",
+      "dependencies": [],
+      "compat": {
+        "minVersion": {
+          "claude_code": "1.0",
+          "cursor": "0.50",
+          "codex": "0.1"
+        },
+        "capabilities": [
+          "read_repo"
+        ]
+      },
+      "manifest": {
+        "author": "wcf-team",
+        "license": "MIT",
+        "entryFormat": "markdown",
+        "sections": [
+          "overview",
+          "do_dont",
+          "references"
+        ],
+        "sizeBytes": 24403,
+        "lastUpdated": "2026-03-04"
+      }
+    },
+    {
+      "name": "wcf-compose",
+      "path": ".claude/skills/wcf-compose",
+      "entry": "SKILL.md",
+      "clients": [
+        "codex",
+        "claude_code",
+        "cursor"
+      ],
+      "status": "active",
+      "description": "Compose screen HTML and state variants from installed component IDs.",
+      "tags": [
+        "workflow"
+      ],
+      "version": "1.0.0",
+      "dependencies": [
+        "wcf-install"
+      ],
+      "compat": {
+        "minVersion": {
+          "claude_code": "1.0",
+          "cursor": "0.50",
+          "codex": "0.1"
+        },
+        "capabilities": [
+          "read_repo",
+          "write_repo"
+        ]
+      },
+      "manifest": {
+        "author": "wcf-team",
+        "license": "MIT",
+        "entryFormat": "markdown",
+        "sections": [
+          "overview",
+          "workflow"
+        ],
+        "sizeBytes": 2333,
+        "lastUpdated": "2026-03-04"
+      }
+    },
+    {
+      "name": "wcf-discovery",
+      "path": ".claude/skills/wcf-discovery",
+      "entry": "SKILL.md",
+      "clients": [
+        "codex",
+        "claude_code",
+        "cursor"
+      ],
+      "status": "active",
+      "description": "Discover component IDs and patterns from screen requirements.",
+      "tags": [
+        "workflow"
+      ],
+      "version": "1.0.0",
+      "dependencies": [],
+      "compat": {
+        "minVersion": {
+          "claude_code": "1.0",
+          "cursor": "0.50",
+          "codex": "0.1"
+        },
+        "capabilities": [
+          "read_repo",
+          "mcp_tools"
+        ]
+      },
+      "manifest": {
+        "author": "wcf-team",
+        "license": "MIT",
+        "entryFormat": "markdown",
+        "sections": [
+          "overview",
+          "workflow"
+        ],
+        "sizeBytes": 2514,
+        "lastUpdated": "2026-03-04"
+      }
+    },
+    {
+      "name": "wcf-install",
+      "path": ".claude/skills/wcf-install",
+      "entry": "SKILL.md",
+      "clients": [
+        "codex",
+        "claude_code",
+        "cursor"
+      ],
+      "status": "active",
+      "description": "Resolve install order and generate WCF install commands.",
+      "tags": [
+        "workflow"
+      ],
+      "version": "1.0.0",
+      "dependencies": [
+        "wcf-discovery"
+      ],
+      "compat": {
+        "minVersion": {
+          "claude_code": "1.0",
+          "cursor": "0.50",
+          "codex": "0.1"
+        },
+        "capabilities": [
+          "read_repo",
+          "run_commands"
+        ]
+      },
+      "manifest": {
+        "author": "wcf-team",
+        "license": "MIT",
+        "entryFormat": "markdown",
+        "sections": [
+          "overview",
+          "workflow"
+        ],
+        "sizeBytes": 2341,
+        "lastUpdated": "2026-03-04"
+      }
+    },
+    {
+      "name": "wcf-ui-builder",
+      "path": ".claude/skills/wcf-ui-builder",
+      "entry": "SKILL.md",
+      "clients": [
+        "codex",
+        "claude_code",
+        "cursor"
+      ],
+      "status": "active",
+      "description": "Orchestrator skill for discovery, install, compose, and validate flow.",
+      "tags": [
+        "workflow"
+      ],
+      "version": "1.0.0",
+      "dependencies": [
+        "wcf-discovery",
+        "wcf-install",
+        "wcf-compose",
+        "wcf-validate"
+      ],
+      "compat": {
+        "minVersion": {
+          "claude_code": "1.0",
+          "cursor": "0.50",
+          "codex": "0.1"
+        },
+        "capabilities": [
+          "read_repo",
+          "write_repo",
+          "mcp_tools"
+        ]
+      },
+      "manifest": {
+        "author": "wcf-team",
+        "license": "MIT",
+        "entryFormat": "markdown",
+        "sections": [
+          "overview",
+          "workflow"
+        ],
+        "sizeBytes": 1986,
+        "lastUpdated": "2026-03-04"
+      }
+    },
+    {
+      "name": "wcf-validate",
+      "path": ".claude/skills/wcf-validate",
+      "entry": "SKILL.md",
+      "clients": [
+        "codex",
+        "claude_code",
+        "cursor"
+      ],
+      "status": "active",
+      "description": "Validate generated markup and return diagnostics with fix suggestions.",
+      "tags": [
+        "audit"
+      ],
+      "version": "1.0.0",
+      "dependencies": [],
+      "compat": {
+        "minVersion": {
+          "claude_code": "1.0",
+          "cursor": "0.50",
+          "codex": "0.1"
+        },
+        "capabilities": [
+          "read_repo",
+          "mcp_tools"
+        ]
+      },
+      "manifest": {
+        "author": "wcf-team",
+        "license": "MIT",
+        "entryFormat": "markdown",
+        "sections": [
+          "overview",
+          "workflow",
+          "do_dont"
+        ],
+        "sizeBytes": 2129,
+        "lastUpdated": "2026-03-04"
+      }
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoharada/wcf-mcp",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "MCP server for the web-components-factory design system. Provides component discovery, validation, and pattern-based UI composition without cloning the repository.",
   "type": "module",
   "bin": {
@@ -9,7 +9,9 @@
   "files": [
     "bin.mjs",
     "core.mjs",
+    "core/",
     "server.mjs",
+    "runtime-data.mjs",
     "validator.mjs",
     "data/",
     "examples/",

package/runtime-data.mjs

@@ -0,0 +1,55 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+export const RUNTIME_FILE_MAP = Object.freeze({
+  'custom-elements.json': 'custom-elements.json',
+  'install-registry.json': 'registry/install-registry.json',
+  'pattern-registry.json': 'registry/pattern-registry.json',
+  'component-selector-guide.json': 'registry/component-selector-guide.json',
+  'design-tokens.json': 'packages/mcp-server/data/design-tokens.json',
+  'guidelines-index.json': 'packages/mcp-server/data/guidelines-index.json',
+  'llms-full.txt': 'llms-full.txt',
+  'skills-registry.json': 'registry/skills-registry.json',
+});
+
+export function resolveRuntimeDataPath(fileName, { repoRoot = process.cwd() } = {}) {
+  const repoRelative = RUNTIME_FILE_MAP[fileName];
+  return repoRelative ? path.join(repoRoot, repoRelative) : undefined;
+}
+
+export function resolveBundledDataPath(fileName, { bundledDir } = {}) {
+  if (!bundledDir) return undefined;
+  return path.join(bundledDir, 'data', fileName);
+}
+
+async function readTextIfExists(targetPath) {
+  if (!targetPath) return null;
+  try {
+    return await fs.readFile(targetPath, 'utf8');
+  } catch {
+    return null;
+  }
+}
+
+export async function loadTextDataWithFallback(fileName, { bundledDir, repoRoot = process.cwd() } = {}) {
+  const bundled = resolveBundledDataPath(fileName, { bundledDir });
+  const repo = resolveRuntimeDataPath(fileName, { repoRoot });
+
+  for (const candidate of [bundled, repo]) {
+    const text = await readTextIfExists(candidate);
+    if (text !== null) return text;
+  }
+
+  throw new Error(`テキストデータファイルが見つかりません: ${fileName}`);
+}
+
+export async function loadJsonDataWithFallback(fileName, options = {}) {
+  const text = await loadTextDataWithFallback(fileName, options);
+  try {
+    return JSON.parse(text);
+  } catch (error) {
+    throw new Error(
+      `データファイルのJSON解析に失敗しました: ${fileName} (${error instanceof Error ? error.message : String(error)})`,
+    );
+  }
+}

package/server.mjs

@@ -10,6 +10,7 @@ import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createMcpServer } from './core.mjs';
+import { loadJsonDataWithFallback, loadTextDataWithFallback } from './runtime-data.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -17,51 +18,24 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // Data loading — bundled data/ first, then repo root fallback
 // ---------------------------------------------------------------------------
 
-const REPO_FILE_MAP = {
-  'custom-elements.json': 'custom-elements.json',
-  'install-registry.json': 'registry/install-registry.json',
-  'pattern-registry.json': 'registry/pattern-registry.json',
-  'component-selector-guide.json': 'registry/component-selector-guide.json',
-  'design-tokens.json': 'design-tokens.json',
-  'guidelines-index.json': 'guidelines-index.json',
-  'llms-full.txt': 'llms-full.txt',
-  'skills-registry.json': 'registry/skills-registry.json',
-};
 export const DEFAULT_WCF_MCP_CONFIG = 'wcf-mcp.config.json';
 
-function resolveDataPath(fileName) {
-  const bundled = path.join(__dirname, 'data', fileName);
-  const repoRoot = path.resolve(process.cwd());
-  const repoRelative = REPO_FILE_MAP[fileName];
-  const repo = repoRelative ? path.join(repoRoot, repoRelative) : undefined;
-  return { bundled, repo };
-}
-
-async function loadJsonData(fileName) {
-  const { bundled, repo } = resolveDataPath(fileName);
-  for (const p of [bundled, repo]) {
-    if (!p) continue;
-    try {
-      const text = await fs.readFile(p, 'utf8');
-      return JSON.parse(text);
-    } catch {
-      // Try next path
-    }
-  }
-  throw new Error(`データファイルが見つかりません: ${fileName}`);
-}
-
-async function loadTextData(fileName) {
-  const { bundled, repo } = resolveDataPath(fileName);
-  for (const p of [bundled, repo]) {
-    if (!p) continue;
-    try {
-      return await fs.readFile(p, 'utf8');
-    } catch {
-      // Try next path
-    }
-  }
-  throw new Error(`テキストデータファイルが見つかりません: ${fileName}`);
+export function createRuntimeDataLoaders({ cwd = process.cwd() } = {}) {
+  const repoRoot = path.resolve(cwd);
+  return {
+    async loadJsonData(fileName) {
+      return loadJsonDataWithFallback(fileName, {
+        bundledDir: __dirname,
+        repoRoot,
+      });
+    },
+    async loadTextData(fileName) {
+      return loadTextDataWithFallback(fileName, {
+        bundledDir: __dirname,
+        repoRoot,
+      });
+    },
+  };
 }
 
 async function loadValidator() {
@@ -228,10 +202,12 @@ export async function loadJsonDataFromPath(sourcePath) {
 // ---------------------------------------------------------------------------
 
 export async function createServer(options = {}) {
+  const runtimeCwd = options.cwd ?? process.cwd();
   const runtimeConfig = await loadWcfMcpRuntimeConfig({
-    cwd: options.cwd ?? process.cwd(),
+    cwd: runtimeCwd,
     configPath: options.configPath,
   });
+  const { loadJsonData, loadTextData } = createRuntimeDataLoaders({ cwd: runtimeCwd });
   return createMcpServer(loadJsonData, loadValidator, {
     plugins: runtimeConfig.plugins,
     loadJsonDataFromPath,