ring-skills-mcp 1.0.0 → 1.0.2

package/README.md

@@ -28,7 +28,25 @@ npm run build
 
 Add the following MCP configuration in Cursor settings:
 
-### Option 1: Run with Node
+### Option 1: Run with npx (Recommended)
+
+```json
+{
+  "mcpServers": {
+    "ring-skills-mcp": {
+      "command": "npx",
+      "args": ["ring-skills-mcp@latest"],
+      "env": {
+        "SKILLS_API_HOST": "http://your-api-host:8000",
+        "SKILLS_REPO": "your-org/skills-repo",
+        "SKILLS_AUTH_TOKEN": "your-auth-token-here"
+      }
+    }
+  }
+}
+```
+
+### Option 2: Run with Node
 
 ```json
 {
@@ -46,7 +64,7 @@ Add the following MCP configuration in Cursor settings:
 }
 ```
 
-### Option 2: Run with npx (development mode)
+### Option 3: Run with npx (development mode)
 
 ```json
 {

package/dist/index.js

@@ -6,17 +6,17 @@ import { exec } from "child_process";
 import { promisify } from "util";
 import path from "path";
 const execAsync = promisify(exec);
-// 配置
+// Configuration
 const DEFAULT_API_HOST = process.env.SKILLS_API_HOST || "";
 const DEFAULT_SKILLS_REPO = process.env.SKILLS_REPO || "anthropics/skills";
 const DEFAULT_AUTH_TOKEN = process.env.SKILLS_AUTH_TOKEN || "";
-// 创建MCP服务器
+// Create MCP server
 const server = new McpServer({
     name: "ring-skills-mcp",
     version: "1.0.0",
 });
 /**
- * 获取Skills列表
+ * Fetch Skills list
  */
 async function fetchSkills(host, search = "", pageSize = 5000, token = "") {
     const url = `${host}/api/skills?search=${encodeURIComponent(search)}&pageSize=${pageSize}`;
@@ -27,10 +27,10 @@ async function fetchSkills(host, search = "", pageSize = 5000, token = "") {
         }
         const response = await fetch(url, { headers });
         if (!response.ok) {
-            throw new Error(`API请求失败: ${response.status} ${response.statusText}`);
+            throw new Error(`API request failed: ${response.status} ${response.statusText}`);
         }
         const data = (await response.json());
-        // 兼容不同的API返回格式
+        // Compatible with different API response formats
         if (Array.isArray(data)) {
             return data;
         }
@@ -47,46 +47,46 @@ async function fetchSkills(host, search = "", pageSize = 5000, token = "") {
     }
     catch (error) {
         if (error instanceof Error) {
-            throw new Error(`获取Skills列表失败: ${error.message}`);
+            throw new Error(`Failed to fetch Skills list: ${error.message}`);
         }
-        throw new Error("获取Skills列表失败: 未知错误");
+        throw new Error("Failed to fetch Skills list: Unknown error");
     }
 }
 /**
- * 安装Skill到指定项目
+ * Install Skill to specified project
  */
 async function installSkill(skillName, projectPath, targetDir = "skills", repo = DEFAULT_SKILLS_REPO) {
-    // 将skill名称转换为小写
+    // Convert skill name to lowercase
     const normalizedName = skillName.toLowerCase();
-    // 构建完整安装路径
+    // Build full installation path
     const destPath = path.join(projectPath, targetDir, normalizedName);
-    // 构建degit命令
+    // Build degit command
     const sourcePath = `${repo}/skills/${normalizedName}`;
     const command = `npx degit ${sourcePath} ${destPath}`;
     try {
         const { stdout, stderr } = await execAsync(command);
-        const output = stdout || stderr || "安装完成";
-        return `✅ Skill "${normalizedName}" 已成功安装到 ${destPath}\n${output}`;
+        const output = stdout || stderr || "Installation completed";
+        return `✅ Skill "${normalizedName}" has been successfully installed to ${destPath}\n${output}`;
     }
     catch (error) {
         if (error instanceof Error) {
-            throw new Error(`安装Skill失败: ${error.message}`);
+            throw new Error(`Failed to install Skill: ${error.message}`);
         }
-        throw new Error("安装Skill失败: 未知错误");
+        throw new Error("Failed to install Skill: Unknown error");
     }
 }
-// 注册工具: 获取Skills列表
-server.tool("list_skills", "获取公司Skills列表。可以通过search参数搜索特定的skill。需要提供Authorization token进行认证。", {
+// Register tool: Fetch Skills list
+server.tool("list_skills", "Fetch company Skills list. You can search for specific skills using the search parameter. Authorization token is required for authentication.", {
     host: z
         .string()
         .optional()
-        .describe(`API服务器地址，默认: ${DEFAULT_API_HOST}`),
-    search: z.string().optional().describe("搜索关键词，用于过滤skills"),
-    pageSize: z.number().optional().describe("每页返回数量，默认: 5000"),
+        .describe(`API server address, default: ${DEFAULT_API_HOST}`),
+    search: z.string().optional().describe("Search keyword for filtering skills"),
+    pageSize: z.number().optional().describe("Number of results per page, default: 5000"),
     token: z
         .string()
         .optional()
-        .describe("Authorization token (必需)，用于API认证。可通过此参数传入或设置环境变量SKILLS_AUTH_TOKEN"),
+        .describe("Authorization token (required) for API authentication. Can be passed as parameter or set via environment variable SKILLS_AUTH_TOKEN"),
 }, async ({ host, search, pageSize, token }) => {
     try {
         const apiHost = host || DEFAULT_API_HOST;
@@ -96,7 +96,7 @@ server.tool("list_skills", "获取公司Skills列表。可以通过search参数
                 content: [
                     {
                         type: "text",
-                        text: "❌ 错误: 缺少Authorization token。请通过token参数提供，或设置环境变量SKILLS_AUTH_TOKEN。",
+                        text: "❌ Error: Missing Authorization token. Please provide via token parameter or set environment variable SKILLS_AUTH_TOKEN.",
                     },
                 ],
                 isError: true,
@@ -108,16 +108,16 @@ server.tool("list_skills", "获取公司Skills列表。可以通过search参数
                 content: [
                     {
                         type: "text",
-                        text: "未找到任何Skills。请检查API地址是否正确或尝试不同的搜索关键词。",
+                        text: "No Skills found. Please check if the API address is correct or try different search keywords.",
                     },
                 ],
             };
         }
-        // 格式化输出
+        // Format output
         const skillsList = skills
             .map((skill, index) => {
-            const title = skill.title || skill.id || "未命名";
-            const summary = skill.summary || "无描述";
+            const title = skill.title || skill.id || "Unnamed";
+            const summary = skill.summary || "No description";
             const category = skill.category ? ` [${skill.category}]` : "";
             return `${index + 1}. **${title}**${category}\n   ${summary}`;
         })
@@ -126,7 +126,7 @@ server.tool("list_skills", "获取公司Skills列表。可以通过search参数
             content: [
                 {
                     type: "text",
-                    text: `## Skills列表 (共 ${skills.length} 个)\n\n${skillsList}`,
+                    text: `## Skills List (${skills.length} total)\n\n${skillsList}`,
                 },
             ],
         };
@@ -136,36 +136,36 @@ server.tool("list_skills", "获取公司Skills列表。可以通过search参数
             content: [
                 {
                     type: "text",
-                    text: `❌ 错误: ${error instanceof Error ? error.message : "未知错误"}`,
+                    text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}`,
                 },
             ],
             isError: true,
         };
     }
 });
-// 注册工具: 安装Skill
-server.tool("install_skill", "根据skill名称安装skill到本地项目。使用npx degit从远程仓库下载skill模板。需要提供项目路径，可以是当前IDE打开文件所在的项目路径。", {
-    skillName: z.string().describe("要安装的skill名称"),
+// Register tool: Install Skill
+server.tool("install_skill", "Install skill to local project by skill name. Uses npx degit to download skill template from remote repository. Project path is required, which can be the project path of the currently opened file in IDE.", {
+    skillName: z.string().describe("Name of the skill to install"),
     projectPath: z
         .string()
         .optional()
-        .describe("项目路径 (必需)，skill将安装到此项目下。请提供当前IDE打开文件所在的项目根目录路径"),
+        .describe("Project path (required), skill will be installed to this project. Please provide the project root directory path of the currently opened file in IDE"),
     targetDir: z
         .string()
         .optional()
-        .describe("安装目标目录，默认: skills"),
+        .describe("Installation target directory, default: skills"),
     repo: z
         .string()
         .optional()
-        .describe(`Skills仓库路径，默认: ${DEFAULT_SKILLS_REPO}`),
+        .describe(`Skills repository path, default: ${DEFAULT_SKILLS_REPO}`),
 }, async ({ skillName, projectPath, targetDir, repo }) => {
-    // 检查是否提供了项目路径
+    // Check if project path is provided
     if (!projectPath) {
         return {
             content: [
                 {
                     type: "text",
-                    text: "❌ 请提供项目路径 (projectPath)。\n\n您可以提供当前IDE打开文件所在的项目根目录路径，skill将安装到该项目的 skills 目录下。\n\n例如: /Users/xxx/my-project",
+                    text: "❌ Please provide project path (projectPath).\n\nYou can provide the project root directory path of the currently opened file in IDE, skill will be installed to the skills directory of that project.\n\nExample: /Users/xxx/my-project",
                 },
             ],
             isError: true,
@@ -187,20 +187,20 @@ server.tool("install_skill", "根据skill名称安装skill到本地项目。使
             content: [
                 {
                     type: "text",
-                    text: `❌ 错误: ${error instanceof Error ? error.message : "未知错误"}`,
+                    text: `❌ Error: ${error instanceof Error ? error.message : "Unknown error"}`,
                 },
             ],
             isError: true,
         };
     }
 });
-// 启动服务器
+// Start server
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error("Ring Skills MCP服务已启动");
+    console.error("Ring Skills MCP service started");
 }
 main().catch((error) => {
-    console.error("服务启动失败:", error);
+    console.error("Service startup failed:", error);
     process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ring-skills-mcp",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "MCP service for fetching and installing company Skills",
   "type": "module",
   "main": "dist/index.js",