@baitong-dev/skills-mcp 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/{SkillsMcpServer.js → dist/index.js}

@@ -11,6 +11,7 @@ const http_1 = require("http");
 const path_1 = __importDefault(require("path"));
 const zod_1 = __importDefault(require("zod"));
 const commander_1 = require("commander");
+const mcp_helpers_1 = require("@baitong-dev/mcp-helpers");
 //  eslint-disable-next-line @typescript-eslint/no-require-imports
 const yamlFront = require('yaml-front-matter');
 // 命令行参数处理
@@ -27,7 +28,6 @@ if (!allowedTransports.includes(cliOptions.transport)) {
 const MCP_NAME = 'Skills MCP';
 const MCP_VERSION = '0.0.1';
 const PORT = parseInt(cliOptions.port, 10);
-const CONFIG_DIR = process.env.MCP_HOME_DIR;
 const TRANSPORT_TYPE = (cliOptions.transport || 'stdio');
 const logInfo = (...args) => {
     if (TRANSPORT_TYPE === 'stdio') {
@@ -38,7 +38,7 @@ const logInfo = (...args) => {
     }
 };
 function getSkillsRootDir() {
-    const dir = path_1.default.join(CONFIG_DIR, 'skills');
+    const dir = path_1.default.join(mcp_helpers_1.MCP_HOME_DIR, 'skills');
     if (!fs_1.default.existsSync(dir)) {
         fs_1.default.mkdirSync(dir, {
             recursive: true
@@ -46,15 +46,27 @@ function getSkillsRootDir() {
     }
     return dir;
 }
-function loadSkillsMetadatas() {
+function loadSkillsMetadata() {
     const skillsRootDirs = fs_1.default.readdirSync(getSkillsRootDir());
+    let skillConfigs;
+    try {
+        skillConfigs =
+            JSON.parse(fs_1.default.readFileSync(path_1.default.join(mcp_helpers_1.MCP_HOME_DIR, 'config', 'skills_config.json'), 'utf-8'))
+                .skills || [];
+    }
+    catch (error) {
+        skillConfigs = [];
+    }
     return skillsRootDirs
-        .map(skillName => {
+        .map(skillDir => {
         try {
-            const { name, description } = readSkillJson(getSkillFilePath(skillName));
+            const { name, description } = readSkillJson(getSkillFilePath(skillDir));
+            const isActive = skillConfigs.find(skill => skill.name === name)?.isActive ?? true;
             return {
-                name: name.trim(),
-                description: description.trim()
+                name,
+                description,
+                cwd: getSkillCwd(skillDir),
+                isActive
             };
         }
         catch (_) {
@@ -71,21 +83,62 @@ function getSkillFilePath(skillName) {
 }
 function readSkillJson(skillFilePath) {
     const skillMd = fs_1.default.readFileSync(skillFilePath, 'utf-8');
-    return yamlFront.loadFront(skillMd);
+    const { name, description, __content } = yamlFront.loadFront(skillMd);
+    return {
+        name: name.toString().trim(),
+        description: description.toString().trim(),
+        __content: __content.trim()
+    };
 }
 function registerLoadSkill(server) {
+    const metadata = loadSkillsMetadata().filter(skill => skill.isActive);
+    const examples = metadata
+        .map(skill => `'${skill.name}'`)
+        .slice(0, 3)
+        .join(', ');
+    const hint = examples.length > 0 ? ` (e.g., ${examples}, ...)` : '';
     server.registerTool('load_skill', {
-        description: `
+        description: metadata.length === 0
+            ? 'Load a specialized skill that provides domain-specific instructions and workflows. No skills are currently available.'
+            : `Load a specialized skill that provides domain-specific instructions and workflows.
+
+When you recognize that a task matches one of the available skills listed below, use this tool to load the full skill instructions.
+
+The skill will inject detailed instructions, workflows, and access to bundled resources (scripts, references, templates) into the conversation context.
+
+The following skills provide specialized sets of instructions for particular tasks.
+
+Invoke this tool to load a skill when a task matches one of the available skills listed below:
+
 Available skills:
-${loadSkillsMetadatas()
-            .map(skill => `- ${skill.name}: ${skill.description}`)
-            .join('\n')}
 
-Returns the skill's prompt and context.`,
+${metadata.map(skill => `- ${skill.name}: ${skill.description}`).join('\n')}`,
         inputSchema: zod_1.default.object({
-            skillName: zod_1.default.string().describe('Name of skill to load')
+            skillName: zod_1.default.string().describe(`The name of the skill from available skills${hint}`)
         })
     }, async ({ skillName }) => {
+        if (metadata.length === 0) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No skills are currently available.'
+                    }
+                ]
+            };
+        }
+        if (!metadata.some(skill => skill.name === skillName)) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: 'text',
+                        text: `Skill "${skillName}" not found.`
+                    }
+                ]
+            };
+        }
         // 返回skill元素据，只包含name和description
         const skillCwd = getSkillCwd(skillName);
         const skillFilePath = getSkillFilePath(skillName);
@@ -96,7 +149,21 @@ Returns the skill's prompt and context.`,
                     type: 'text',
                     text: `Base directory for this skill: ${skillCwd}
 
-${json.__content.trim()}`
+${json.__content}`
+                }
+            ]
+        };
+    });
+}
+function registerRefreshSkills(server) {
+    server.registerTool('reload_skills', {
+        description: `Reload skills metadata. Especially after creating a new skill.` // 尤其在创建技能后要调用下重新加载技能
+    }, async () => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Skills metadata reloaded.`
                 }
             ]
         };
@@ -114,6 +181,7 @@ function createServerInstance() {
     });
     // 注册所有工具
     registerLoadSkill(server);
+    registerRefreshSkills(server);
     return server;
 }
 async function main() {

package/package.json

@@ -1,15 +1,14 @@
 {
   "name": "@baitong-dev/skills-mcp",
-  "version": "0.0.1",
-  "main": "SkillsMcpServer.js",
+  "version": "0.0.2",
+  "main": "./dist/index.js",
   "bin": {
-    "@baitong-dev/skills-mcp": "./SkillsMcpServer.js"
+    "@baitong-dev/skills-mcp": "./dist/index.js"
   },
   "files": [
-    "SkillsMcpServer.js",
+    "dist",
     "README.md"
   ],
-  "scripts": {},
   "keywords": [
     "mcp",
     "skills"
@@ -19,10 +18,14 @@
     "@modelcontextprotocol/sdk": "^1.25.1",
     "commander": "^14.0.3",
     "yaml-front-matter": "^4.1.1",
-    "zod": "^4.3.4"
+    "zod": "^4.3.4",
+    "@baitong-dev/mcp-helpers": "0.0.1"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "tsc": "tsc ./src/index.ts  --declaration --module commonjs  --target es2021 --esModuleInterop --outDir ./dist"
   }
-}
+}