ring-skills-mcp 1.0.6 → 1.0.8

package/README.md

@@ -5,7 +5,7 @@ An MCP (Model Context Protocol) service for fetching and installing company Skil
 ## Features
 
 - **list_skills** - Fetch company Skills list, supports search and pagination
-- **install_skill** - Install skill to local project by skill name
+- **install_skill** - Install skill to local project by gitUrl (supports GitHub and GitLab)
 
 ## Installation
 
@@ -20,8 +20,7 @@ npm run build
 
 | Variable | Description | Default |
 |----------|-------------|---------|
-| `SKILLS_API_HOST` | API server address | `SKILLS_API_HOST` |
-| `SKILLS_REPO` | Skills repository path | `anthropics/skills` |
+| `SKILLS_API_HOST` | API server address | None |
 | `SKILLS_AUTH_TOKEN` | API authentication token (required) | None |
 
 ## Usage in Cursor
@@ -38,7 +37,6 @@ Add the following MCP configuration in Cursor settings:
       "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"
       }
     }
@@ -55,8 +53,7 @@ Add the following MCP configuration in Cursor settings:
       "command": "node",
       "args": ["/path/to/ring-skills-mcp/dist/index.js"],
       "env": {
-        "SKILLS_API_HOST": "SKILLS_API_HOST",
-        "SKILLS_REPO": "your-org/skills-repo",
+        "SKILLS_API_HOST": "http://your-api-host:8000",
         "SKILLS_AUTH_TOKEN": "your-auth-token-here"
       }
     }
@@ -73,8 +70,7 @@ Add the following MCP configuration in Cursor settings:
       "command": "npx",
       "args": ["tsx", "/path/to/ring-skills-mcp/src/index.ts"],
       "env": {
-        "SKILLS_API_HOST": "SKILLS_API_HOST",
-        "SKILLS_REPO": "your-org/skills-repo",
+        "SKILLS_API_HOST": "http://your-api-host:8000",
         "SKILLS_AUTH_TOKEN": "your-auth-token-here"
       }
     }
@@ -102,17 +98,33 @@ Search for skills containing "pdf"
 
 ### install_skill
 
-Install the specified skill to local project.
+Install the specified skill to local project by gitUrl.
 
 **Parameters:**
-- `skillName` (required): Name of the skill to install
+- `gitUrl` (required): Git URL of the skill. Supports both GitHub and GitLab URLs.
 - `projectPath` (required): Project path where the skill will be installed. Please provide the project root directory path of the currently opened file in IDE
-- `targetDir` (optional): Installation target directory, default is `skills`
-- `repo` (optional): Skills repository path
+- `targetDir` (optional): Installation target directory, default is `.claude/skills`
+
+**Supported URL Formats:**
+
+| Platform | URL Format | Installation Method |
+|----------|------------|---------------------|
+| GitHub | `https://github.com/{owner}/{repo}/tree/{branch}/{path}` | `npx degit` (fast, no git history) |
+| GitLab | `https://{host}/{owner}/{repo}/-/tree/{branch}/{path}` | `git sparse-checkout` via SSH (no login required for internal networks) |
+
+**Example URLs:**
+```
+# GitHub
+https://github.com/anthropics/skills/tree/main/skills/docx
+
+# GitLab (self-hosted)
+https://git.ringcentral.com/ai-testing/aiter-skills/-/tree/main/.agent/skills/nova-scripts-generator
+```
 
 **Example usage:**
 ```
-Install pdf skill to /Users/xxx/my-project project
+Install skill from GitHub URL to /Users/xxx/my-project
+Install skill from GitLab URL to /Users/xxx/my-project
 ```
 
 ## Development

package/dist/index.js

@@ -98,18 +98,45 @@ function parseGitUrl(gitUrl) {
     return null;
 }
 /**
- * Build degit source path from git URL info
+ * Install Skill from GitHub using degit
  */
-function buildDegitSource(urlInfo) {
-    if (urlInfo.type === "github") {
-        // GitHub: owner/repo/path#branch
-        return `${urlInfo.owner}/${urlInfo.repo}/${urlInfo.skillPath}#${urlInfo.branch}`;
-    }
-    else if (urlInfo.type === "gitlab") {
-        // GitLab (self-hosted): host:owner/repo/path#branch
-        return `${urlInfo.host}:${urlInfo.owner}/${urlInfo.repo}/${urlInfo.skillPath}#${urlInfo.branch}`;
-    }
-    return "";
+async function installFromGitHub(urlInfo, destPath) {
+    // GitHub: owner/repo/path#branch
+    const sourcePath = `${urlInfo.owner}/${urlInfo.repo}/${urlInfo.skillPath}#${urlInfo.branch}`;
+    const command = `npx degit ${sourcePath} ${destPath}`;
+    const { stdout, stderr } = await execAsync(command);
+    const output = stdout || stderr || "Installation completed";
+    return `✅ Skill "${urlInfo.skillName}" has been successfully installed to ${destPath}\n\nSource: ${sourcePath}\n${output}`;
+}
+/**
+ * Install Skill from GitLab using git sparse-checkout
+ * For private GitLab repositories that degit doesn't support
+ * Uses SSH format for internal networks (no login required)
+ */
+async function installFromGitLab(urlInfo, destPath) {
+    const skillsDir = path.dirname(destPath);
+    const tempDir = `temp-${urlInfo.skillName}-${Date.now()}`;
+    // Use SSH format for GitLab (no login required for internal networks)
+    const repoUrl = `git@${urlInfo.host}:${urlInfo.owner}/${urlInfo.repo}.git`;
+    // Build command sequence:
+    // 1. Create target directory
+    // 2. Clone with sparse checkout
+    // 3. Set sparse-checkout path
+    // 4. Move skill folder to destination
+    // 5. Cleanup temp directory
+    const commands = [
+        `mkdir -p ${skillsDir}`,
+        `cd ${skillsDir}`,
+        `git clone --depth 1 --filter=blob:none --sparse ${repoUrl} ${tempDir}`,
+        `cd ${tempDir}`,
+        `git sparse-checkout set ${urlInfo.skillPath}`,
+        `cd ..`,
+        `mv ${tempDir}/${urlInfo.skillPath} ${urlInfo.skillName}`,
+        `rm -rf ${tempDir}`,
+    ].join(" && ");
+    const { stdout, stderr } = await execAsync(commands);
+    const output = stdout || stderr || "Installation completed";
+    return `✅ Skill "${urlInfo.skillName}" has been successfully installed to ${destPath}\n\nSource: ${repoUrl} (${urlInfo.skillPath})\n${output}`;
 }
 /**
  * Install Skill to specified project using gitUrl
@@ -121,15 +148,18 @@ async function installSkillFromGitUrl(gitUrl, projectPath, targetDir = ".claude/
     }
     const skillName = urlInfo.skillName;
     const destPath = path.join(projectPath, targetDir, skillName);
-    const sourcePath = buildDegitSource(urlInfo);
-    if (!sourcePath) {
-        throw new Error(`Could not build degit source from URL: ${gitUrl}`);
-    }
-    const command = `npx degit ${sourcePath} ${destPath}`;
     try {
-        const { stdout, stderr } = await execAsync(command);
-        const output = stdout || stderr || "Installation completed";
-        return `✅ Skill "${skillName}" has been successfully installed to ${destPath}\n\nSource: ${sourcePath}\n${output}`;
+        if (urlInfo.type === "github") {
+            // Use degit for GitHub (faster, no git history)
+            return await installFromGitHub(urlInfo, destPath);
+        }
+        else if (urlInfo.type === "gitlab") {
+            // Use git sparse-checkout for GitLab (supports private repos)
+            return await installFromGitLab(urlInfo, destPath);
+        }
+        else {
+            throw new Error(`Unsupported git URL type: ${gitUrl}`);
+        }
     }
     catch (error) {
         if (error instanceof Error) {
@@ -208,7 +238,7 @@ server.tool("list_skills", "Fetch company Skills list. You can search for specif
     }
 });
 // Register tool: Install Skill
-server.tool("install_skill", "Install skill to local project by gitUrl. 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.", {
+server.tool("install_skill", "Install skill to local project by gitUrl. Uses npx degit for GitHub repositories and git sparse-checkout for GitLab repositories. Project path is required, which can be the project path of the currently opened file in IDE.", {
     gitUrl: z.string().describe("Git URL of the skill (e.g., 'https://github.com/anthropics/skills/tree/main/skills/webapp-testing'). The skill name will be extracted from this URL."),
     projectPath: z
         .string()

package/package.json

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