@blueking/bkui-knowledge 0.0.1-beta.11 → 0.0.1-beta.13

package/README.md

@@ -8,7 +8,7 @@
 
 ## 快速开始
 
-只需添加 MCP 服务配置：
+只需添加 MCP 服务配置（通过 `--ide` 参数指定目标 IDE，不指定时默认使用 Cursor）：
 
 ### Cursor（默认）
 
@@ -36,10 +36,29 @@
 }
 ```
 
-> 💡 通过 `--ide` 参数指定目标 IDE，不指定时默认使用 Cursor
+### Claude Code
+
+> Claude Code 支持从 MCP initialize 请求自动获取项目路径，无需手动传入
+
+在 Claude Code 的 MCP 配置文件（`~/.claude/.claude.json` 或项目根目录 `.mcp.json`）中添加：
+
+```json
+{
+  "mcpServers": {
+    "bkui-knowledge": {
+      "command": "npx",
+      "args": ["-y", "@blueking/bkui-knowledge", "--ide=claude-code"]
+    }
+  }
+}
+```
 
 ### 本地开发
 
+- 必须传递项目路径，否则 skills 无法同步到正确位置
+
+- 使用 CodeBuddy 或者 Claude Code 本地开发时，无需 `"${workspaceFolder}"` 参数
+
 ```json
 {
   "mcpServers": {
@@ -54,11 +73,9 @@
 }
 ```
 
-> ⚠️ 必须传递项目路径，否则 skills 无法同步到正确位置
-
 **特性：**
 
-- ✅ 支持 Cursor 和 CodeBuddy 两种 IDE
+- ✅ 支持 Cursor、CodeBuddy 和 Claude Code 三种 IDE
 - ✅ 首次启动自动同步推荐 skills
 - ✅ 自动生成规则文件（自动注入 AI 上下文）
 - ✅ 自动检测版本更新，增量同步
@@ -81,6 +98,7 @@ MCP 服务启动时，skills 会自动同步到用户项目：
 | ------------- | -------------------- | ------------------------------------ |
 | Cursor (默认) | `.cursor/skills/`    | `.cursor/.bkui-knowledge-version`    |
 | CodeBuddy     | `.codebuddy/skills/` | `.codebuddy/.bkui-knowledge-version` |
+| Claude Code   | `.claude/skills/`    | `.claude/.bkui-knowledge-version`    |
 
 **更新机制**：
 
@@ -404,11 +422,11 @@ A: 发布新版本 npm 包后，用户下次启动 IDE 时 `npx -y` 会自动拉
 
 ### Q: skills 没有同步成功？
 
-A: 检查对应 IDE 的 skills 目录是否存在（Cursor: `.cursor/skills/`，CodeBuddy: `.codebuddy/skills/`），或查看 IDE 的 MCP 日志
+A: 检查对应 IDE 的 skills 目录是否存在（Cursor: `.cursor/skills/`，CodeBuddy: `.codebuddy/skills/`，Claude Code: `.claude/skills/`），或查看 IDE 的 MCP 日志
 
-### Q: 如何切换到 CodeBuddy？
+### Q: 如何切换到其他 IDE？
 
-A: 在 MCP 配置的 args 中添加 `--ide=codebuddy` 参数
+A: 在 MCP 配置的 args 中添加 `--ide=codebuddy` 或 `--ide=claude-code` 参数
 
 ---
 

package/bin/bkui-knowledge.js

@@ -208,6 +208,35 @@ function scanSkillDir(dirPath, relativePath) {
   return results;
 }
 
+/**
+ * 重写 SKILL.md 的 frontmatter 以符合 Claude Code 格式要求
+ * Claude Code 要求 name 字段必须是小写字母、数字和连字符
+ * @param {string} content - 原始内容
+ * @param {string} skillId - skill ID (用作 name)
+ * @param {object} skill - manifest 中的 skill 信息
+ * @returns {string} 重写后的内容
+ */
+function rewriteFrontmatterForClaudeCode(content, skillId, skill) {
+  // 解析 frontmatter
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+  if (!frontmatterMatch) {
+    // 没有 frontmatter，添加一个
+    return `---\nname: ${skillId}\ndescription: ${skill.description || skill.name}\n---\n\n${content}`;
+  }
+
+  const frontmatter = frontmatterMatch[1];
+  const body = frontmatterMatch[2];
+
+  // 提取 description（从原始 frontmatter 或 skill 信息）
+  const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+  const description = descMatch ? descMatch[1].trim() : (skill.description || skill.name);
+
+  // 创建新的 Claude Code 兼容 frontmatter
+  const newFrontmatter = `---\nname: ${skillId}\ndescription: ${description}\n---`;
+
+  return `${newFrontmatter}\n${body}`;
+}
+
 /**
  * 生成 skill 的可用资源列表
  * @param {string} skillDir - skill 目录路径
@@ -267,6 +296,8 @@ function syncSkills(projectRoot, ideConfig) {
 
     // 同步推荐的 skills
     let count = 0;
+    const isClaudeCode = ideConfig.name === 'Claude Code';
+    
     for (const skillId of recommendedIds) {
       const skill = manifest.skills.items.find(s => s.id === skillId);
       if (!skill) continue;
@@ -282,7 +313,20 @@ function syncSkills(projectRoot, ideConfig) {
       const resourcesList = generateResourcesList(skillDir, skillId);
       content += resourcesList;
 
-      fs.writeFileSync(path.join(skillsDir, `${skillId}.md`), content, 'utf-8');
+      if (isClaudeCode) {
+        // Claude Code 要求每个 skill 在独立子目录，文件名为 SKILL.md
+        // 并且 name 字段必须是小写字母、数字和连字符
+        const skillSubDir = path.join(skillsDir, skillId);
+        fs.mkdirSync(skillSubDir, { recursive: true });
+        
+        // 重写 frontmatter 以符合 Claude Code 格式要求
+        content = rewriteFrontmatterForClaudeCode(content, skillId, skill);
+        
+        fs.writeFileSync(path.join(skillSubDir, 'SKILL.md'), content, 'utf-8');
+      } else {
+        // Cursor / CodeBuddy 直接放在 skills 目录
+        fs.writeFileSync(path.join(skillsDir, `${skillId}.md`), content, 'utf-8');
+      }
 
       log(`  ✓ ${skillId}`);
       count++;
@@ -315,22 +359,32 @@ async function startMcpServer() {
       // 从 initialize 请求中提取项目路径
       const params = message.params || {};
 
-      // 尝试从 rootUri 或 workspaceFolders 获取项目路径
+      // 打印 initialize 参数用于调试
+      log(`initialize params: ${JSON.stringify({ rootUri: params.rootUri, workspaceFolders: params.workspaceFolders, roots: params.roots })}`);
+
+      // 尝试从 rootUri 或 workspaceFolders 或 roots 获取项目路径
       if (params.rootUri) {
         mcpRootUri = uriToPath(params.rootUri);
-        log(`从 MCP initialize 获取项目路径: ${mcpRootUri}`);
+        log(`从 MCP initialize.rootUri 获取项目路径: ${mcpRootUri}`);
       } else if (params.workspaceFolders && params.workspaceFolders.length > 0) {
         mcpRootUri = uriToPath(params.workspaceFolders[0].uri);
-        log(`从 MCP workspaceFolders 获取项目路径: ${mcpRootUri}`);
+        log(`从 MCP initialize.workspaceFolders 获取项目路径: ${mcpRootUri}`);
+      } else if (params.roots && params.roots.length > 0) {
+        // Claude Code 使用 roots 字段
+        mcpRootUri = uriToPath(params.roots[0].uri);
+        log(`从 MCP initialize.roots 获取项目路径: ${mcpRootUri}`);
       }
 
       // 延迟同步 skills（在获取到项目路径后）
-      if (!skillsSynced && mcpRootUri) {
+      // 如果没有获取到 mcpRootUri，回退到 cwd
+      if (!skillsSynced) {
         const projectRoot = getProjectRoot();
         const ideConfig = getIDEConfig();
-        log(`[延迟同步] 工作目录: ${projectRoot}, IDE: ${ideConfig.name}`);
-        syncSkills(projectRoot, ideConfig);
-        skillsSynced = true;
+        if (projectRoot) {
+          log(`[延迟同步] 工作目录: ${projectRoot}, IDE: ${ideConfig.name}`);
+          syncSkills(projectRoot, ideConfig);
+          skillsSynced = true;
+        }
       }
 
       return {

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@blueking/bkui-knowledge",
-  "version": "0.0.1-beta.11",
+  "version": "0.0.1-beta.13",
   "description": "蓝鲸前端知识库 MCP 服务 - 自动同步 skills，支持 Cursor/CodeBuddy",
   "main": "server/mcp-core.js",
   "bin": {
-    "bkui-knowledge": "./bin/bkui-knowledge.js"
+    "bkui-knowledge": "./bin/bkui-knowledge.js",
+    "bkui-knowledge-mcp": "./bin/bkui-knowledge.js"
   },
   "files": [
     "bin/",