ring-skills-mcp 1.3.2 → 1.3.3

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/package.json

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