ring-skills-mcp 1.3.2 → 1.3.4

package/README.md

@@ -7,6 +7,8 @@ An MCP (Model Context Protocol) service for fetching and installing company Skil
 - **list_skills** - Fetch company Skills and Skill Groups list, supports search and pagination
 - **install_skill** - Install skill to local project by gitUrl (supports GitHub and GitLab)
 - **install_skill_group** - Install all skills from a skill group to local project
+- **check_gitlab_credentials** - Check if GitLab credentials are configured for a host
+- **setup_gitlab_credentials** - Configure GitLab credentials for private repository access
 
 ## Installation
 
@@ -110,6 +112,8 @@ Install the specified skill to local project by gitUrl.
 - `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 `.claude/skills`
+- `gitToken` (optional): GitLab Personal Access Token for private repository authentication. If provided, will be saved for future use.
+- `saveCredentials` (optional): Whether to save the token for future use. Default: true
 
 **Supported URL Formats:**
 
@@ -131,6 +135,7 @@ https://git.ringcentral.com/ai-testing/aiter-skills/-/tree/main/.agent/skills/no
 ```
 Install skill from GitHub URL to /Users/xxx/my-project
 Install skill from GitLab URL to /Users/xxx/my-project
+Install skill from private GitLab with token: gitToken=glpat-xxxx
 ```
 
 ### install_skill_group
@@ -143,6 +148,7 @@ Install all skills from a skill group to local project.
 - `token` (optional): Authorization token, can be passed as parameter or set via environment variable `SKILLS_AUTH_TOKEN`
 - `projectPath` (required): Project path where the skills will be installed
 - `targetDir` (optional): Installation target directory, default is `.claude/skills`
+- `gitToken` (optional): GitLab Personal Access Token for private repository authentication
 
 **Example usage:**
 ```
@@ -154,6 +160,78 @@ Install all skills from skill group "697190fc88f4e586fb1a7114" to /Users/xxx/my-
 - Lists all successfully installed skills
 - Reports any installation errors
 
+### check_gitlab_credentials
+
+Check if GitLab credentials are already configured for a host.
+
+**Parameters:**
+- `host` (required): GitLab host domain to check (e.g., 'git.ringcentral.com')
+
+**Example usage:**
+```
+check_gitlab_credentials:
+  host: git.ringcentral.com
+```
+
+**Returns:**
+- ✅ Credentials configured - if credentials exist
+- ⚠️ No credentials found - if credentials need to be configured
+
+### setup_gitlab_credentials
+
+Configure GitLab credentials for private repository access. The token will be saved to your system's git credential store.
+
+**Parameters:**
+- `host` (required): GitLab host domain (e.g., 'git.ringcentral.com')
+- `token` (required): GitLab Personal Access Token with 'read_repository' scope
+- `force` (optional): Force overwrite even if credentials already exist. Default: false
+
+**How to create a Personal Access Token:**
+1. Open `https://{host}/-/user_settings/personal_access_tokens`
+2. Login to your GitLab account
+3. Create a new Token:
+   - Token name: `ring-skills-mcp`
+   - Expiration: Select a date (recommended: 1 year)
+   - Scopes: Check `read_repository`
+4. Click "Create personal access token"
+5. Copy the generated Token
+
+**Example usage:**
+```
+setup_gitlab_credentials:
+  host: git.ringcentral.com
+  token: glpat-xxxxxxxxxxxx
+```
+
+## GitLab Private Repository Authentication
+
+For private GitLab repositories, you have two options:
+
+### Option 1: Pre-configure credentials (Recommended)
+
+```
+# First, setup credentials
+setup_gitlab_credentials:
+  host: git.ringcentral.com
+  token: glpat-xxxxxxxxxxxx
+
+# Then install skills without providing token each time
+install_skill:
+  gitUrl: https://git.ringcentral.com/...
+  projectPath: /path/to/project
+```
+
+### Option 2: Provide token with each installation
+
+```
+install_skill:
+  gitUrl: https://git.ringcentral.com/...
+  projectPath: /path/to/project
+  gitToken: glpat-xxxxxxxxxxxx
+```
+
+The token will be automatically saved for future use.
+
 ## Development
 
 ```bash

package/dist/index.js

@@ -5,6 +5,7 @@ import { z } from "zod";
 import { exec } from "child_process";
 import { promisify } from "util";
 import path from "path";
+import fs from "fs/promises";
 const execAsync = promisify(exec);
 /**
  * Check if error message indicates authentication failure
@@ -313,6 +314,34 @@ async function installFromGitHub(urlInfo, destPath) {
     const output = stdout || stderr || "Installation completed";
     return `✅ Skill "${urlInfo.skillName}" has been successfully installed to ${destPath}\n\nSource: ${sourcePath}\n${output}`;
 }
+/**
+ * Recursively remove a directory (cross-platform)
+ */
+async function removeDirectory(dirPath) {
+    try {
+        await fs.rm(dirPath, { recursive: true, force: true });
+    }
+    catch {
+        // Ignore errors if directory doesn't exist
+    }
+}
+/**
+ * Recursively copy a directory (cross-platform)
+ */
+async function copyDirectory(src, dest) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirectory(srcPath, destPath);
+        }
+        else {
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
 /**
  * Install Skill from GitLab using git sparse-checkout
  * For private GitLab repositories that degit doesn't support
@@ -323,7 +352,7 @@ async function installFromGitHub(urlInfo, destPath) {
  */
 async function installFromGitLab(urlInfo, destPath, gitToken, saveCredentials = true) {
     const skillsDir = path.dirname(destPath);
-    const tempDir = `temp-${urlInfo.skillName}-${Date.now()}`;
+    const tempDir = path.join(skillsDir, `temp-${urlInfo.skillName}-${Date.now()}`);
     // Build repo URL - if token provided, use authenticated URL with oauth2 username
     let repoUrl;
     let displayUrl;
@@ -336,25 +365,18 @@ async function installFromGitLab(urlInfo, destPath, gitToken, saveCredentials =
         repoUrl = `https://${urlInfo.host}/${urlInfo.owner}/${urlInfo.repo}.git`;
         displayUrl = repoUrl;
     }
-    // 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(" && ");
     try {
-        const { stdout, stderr } = await execAsync(commands);
-        const output = stdout || stderr || "Installation completed";
+        // Step 1: Create target directory (cross-platform)
+        await fs.mkdir(skillsDir, { recursive: true });
+        // Step 2: Clone with sparse checkout
+        await execAsync(`git clone --depth 1 --filter=blob:none --sparse "${repoUrl}" "${tempDir}"`);
+        // Step 3: Set sparse-checkout path
+        await execAsync(`git -C "${tempDir}" sparse-checkout set "${urlInfo.skillPath}"`);
+        // Step 4: Copy skill folder to destination (cross-platform)
+        const sourcePath = path.join(tempDir, urlInfo.skillPath);
+        await copyDirectory(sourcePath, destPath);
+        // Step 5: Cleanup temp directory (cross-platform)
+        await removeDirectory(tempDir);
         // If we used a token and saveCredentials is true, save credentials for future use
         if (gitToken && saveCredentials) {
             try {
@@ -364,21 +386,18 @@ async function installFromGitLab(urlInfo, destPath, gitToken, saveCredentials =
                 // Silently fail credential saving - installation was successful
             }
         }
-        return `✅ Skill "${urlInfo.skillName}" has been successfully installed to ${destPath}\n\nSource: ${displayUrl} (${urlInfo.skillPath})\n${output}`;
+        return `✅ Skill "${urlInfo.skillName}" has been successfully installed to ${destPath}\n\nSource: ${displayUrl} (${urlInfo.skillPath})`;
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
         // Check if this is an authentication error
         if (isAuthenticationError(errorMessage)) {
-            // Clean up any partial temp directory
-            try {
-                await execAsync(`rm -rf ${path.join(skillsDir, tempDir)}`);
-            }
-            catch {
-                // Ignore cleanup errors
-            }
+            // Clean up any partial temp directory (cross-platform)
+            await removeDirectory(tempDir);
             throw new Error(generateAuthErrorMessage(urlInfo.host, displayUrl));
         }
+        // Clean up on any error
+        await removeDirectory(tempDir);
         throw error;
     }
 }

package/package.json

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