@monoharada/wcf-mcp 0.7.0 → 0.9.0

package/README.md

@@ -78,7 +78,7 @@ claude mcp add wcf -- npx @monoharada/wcf-mcp
 }
 ```
 
-## 提供機能（16 tools + 1 prompt + 4 resources）
+## 提供機能（16 tools + 1 prompt + 5 resources）
 
 ### ガードレール
 
@@ -242,6 +242,7 @@ claude mcp add wcf -- npx @monoharada/wcf-mcp
 | `wcf://tokens` | トークン summary（type/category/themes/sample） |
 | `wcf://guidelines/{topic}` | topic 別ガイドライン要約（`accessibility`,`css`,`patterns`,`all`） |
 | `wcf://llms-full` | `llms-full.txt` の全文 |
+| `wcf://skills` | 登録済み Claude Code / Cursor / Codex スキルカタログ（skills-registry.json ベース） |
 
 ### Figma MCP との併用
 

package/core.mjs

@@ -17,8 +17,25 @@ export const CANONICAL_PREFIX = 'dads';
 export const MAX_PREFIX_LENGTH = 64;
 export const STRUCTURED_CONTENT_DISABLE_FLAG = 'WCF_MCP_DISABLE_STRUCTURED_CONTENT';
 export const MAX_TOOL_RESULT_BYTES = 100 * 1024;
-export const PLUGIN_TOOL_NOTICE = 'Plugin tool (contract v1).';
-export const PLUGIN_CONTRACT_VERSION = '1.0.0';
+export const PLUGIN_TOOL_NOTICE = 'Plugin tool (contract v1.1).';
+export const PLUGIN_CONTRACT_VERSION = '1.1.0';
+
+/**
+ * Convert a plugin tool's inputSchema to a passthrough Zod schema.
+ * Handles three cases:
+ *  - Already a Zod schema instance (has _def or _zod) → apply .passthrough()
+ *  - Plain object (raw shape map) → wrap with z.object().passthrough()
+ *  - Falsy / empty → z.object({}).passthrough()
+ */
+function toPassthroughSchema(schema) {
+  if (schema && (schema._def || schema._zod)) {
+    // Already a Zod schema — apply passthrough if it's an object type
+    return typeof schema.passthrough === 'function'
+      ? schema.passthrough()
+      : schema;
+  }
+  return z.object(schema ?? {}).passthrough();
+}
 
 export const CATEGORY_MAP = {
   'dads-input-text': 'Form',
@@ -135,8 +152,24 @@ export const WCF_RESOURCE_URIS = Object.freeze({
   tokens: 'wcf://tokens',
   guidelinesTemplate: 'wcf://guidelines/{topic}',
   llmsFull: 'wcf://llms-full',
+  skills: 'wcf://skills',
 });
 
+/** Normalize a skill entry to summary fields (omit compat/manifest for wcf://skills). */
+function normalizeSkillSummary(s) {
+  return {
+    name: s.name,
+    description: s.description ?? '',
+    status: s.status ?? 'active',
+    path: s.path ?? '',
+    entry: s.entry ?? 'SKILL.md',
+    clients: Array.isArray(s.clients) ? s.clients : [],
+    tags: Array.isArray(s.tags) ? s.tags : [],
+    version: typeof s.version === 'string' ? s.version : '0.0.0',
+    dependencies: Array.isArray(s.dependencies) ? s.dependencies : [],
+  };
+}
+
 // Unidirectional synonym table: key → expands to include these terms (DIG-09)
 // Searching "keyboard" also matches "focus", "tab" etc. but NOT reverse.
 const SYNONYM_TABLE = new Map([
@@ -722,7 +755,7 @@ function toPluginErrorMessage(name, reason) {
  *   name: string,
  *   description?: string,
  *   inputSchema?: Record<string, unknown>,
- *   handler?: (args: Record<string, unknown>, context: { plugin: { name: string, version: string }, helpers: { loadJsonData: Function } }) => unknown,
+ *   handler?: (args: Record<string, unknown>, context: { plugin: { name: string, version: string }, helpers: { loadJsonData: Function, loadTextData: Function } }) => unknown,
  *   staticPayload?: unknown,
  * }} WcfMcpPluginTool
  */
@@ -2137,6 +2170,33 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
     },
   );
 
+  // -----------------------------------------------------------------------
+  // Resource: wcf://skills
+  // -----------------------------------------------------------------------
+  server.registerResource(
+    'wcf_skills',
+    WCF_RESOURCE_URIS.skills,
+    {
+      title: 'WCF Skills Catalog',
+      description: 'Registered Claude Code / Cursor / Codex skills from skills-registry.json.',
+      mimeType: 'application/json',
+    },
+    async () => {
+      const registry = await loadJsonData('skills-registry.json');
+      if (!registry || !Array.isArray(registry.skills)) {
+        throw new Error('SKILLS_REGISTRY_UNAVAILABLE: skills-registry.json is not available.');
+      }
+      const skills = registry.skills.map(normalizeSkillSummary);
+      return {
+        contents: [{
+          uri: WCF_RESOURCE_URIS.skills,
+          mimeType: 'application/json',
+          text: JSON.stringify({ schemaVersion: registry.schemaVersion ?? 2, total: skills.length, skills }, null, 2),
+        }],
+      };
+    },
+  );
+
   // -----------------------------------------------------------------------
   // Tool: get_design_system_overview
   // -----------------------------------------------------------------------
@@ -2232,6 +2292,10 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
             uri: WCF_RESOURCE_URIS.llmsFull,
             purpose: 'Full LLM reference text for WCF',
           },
+          {
+            uri: WCF_RESOURCE_URIS.skills,
+            purpose: 'Skills catalog snapshot',
+          },
         ],
         availableTools: [
           { name: 'get_design_system_overview', purpose: 'This overview (start here)' },
@@ -3326,7 +3390,7 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
         tool.name,
         {
           description: tool.description,
-          inputSchema: tool.inputSchema ?? {},
+          inputSchema: toPassthroughSchema(tool.inputSchema),
         },
         async (args) => {
           try {
@@ -3335,6 +3399,7 @@ export async function createMcpServer(loadJsonData, loadValidator, options = {})
                 plugin: { name: plugin.name, version: plugin.version },
                 helpers: {
                   loadJsonData: loadJson,
+                  loadTextData: loadText,
                   buildJsonToolResponse,
                   normalizePrefix,
                   withPrefix,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoharada/wcf-mcp",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "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": {

package/server.mjs

@@ -25,6 +25,7 @@ const REPO_FILE_MAP = {
   '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';