skillsmp-mcp-lite 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +61 -61
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,114 +1,114 @@
1
- # SkillsMP MCP Server
1
+ # SkillsMP MCP Server (Lite)
2
2
 
3
- An MCP (Model Context Protocol) server that enables AI assistants to search for skills from [SkillsMP](https://skillsmp.com) marketplace before starting any task.
3
+ A lightweight MCP server that enables AI assistants to search for skills from [SkillsMP](https://skillsmp.com) marketplace before starting any task.
4
4
 
5
5
  ## Features
6
6
 
7
7
  - **Keyword Search**: Search skills using specific keywords like "PDF", "web scraper", "SEO"
8
8
  - **AI Semantic Search**: Find skills using natural language descriptions powered by Cloudflare AI
9
9
 
10
- ## Installation
10
+ ## Quick Setup
11
11
 
12
- ```bash
13
- npm install
14
- npm run build
15
- ```
16
-
17
- ## Configuration
18
-
19
- ### Environment Variables
20
-
21
- | Variable | Required | Description |
22
- | ------------------ | -------- | --------------------- |
23
- | `SKILLSMP_API_KEY` | Yes | Your SkillsMP API key |
12
+ No installation required! Just add the config to your AI client.
24
13
 
25
- Get your API key from: https://skillsmp.com/docs/api
26
-
27
- ### VS Code / Cursor Setup
14
+ ### VS Code / GitHub Copilot
28
15
 
29
- Add to your `settings.json`:
16
+ Add to your VS Code `mcp.json` (open with: `Ctrl+Shift+P` → "MCP: Open User Configuration"):
30
17
 
31
18
  ```json
32
19
  {
33
- "mcp": {
34
- "servers": {
35
- "skillsmp": {
36
- "command": "node",
37
- "args": ["path/to/skillsmp-mcp-server/dist/index.js"],
38
- "env": {
39
- "SKILLSMP_API_KEY": "sk_live_skillsmp_YOUR_API_KEY"
40
- }
20
+ "servers": {
21
+ "skillsmp": {
22
+ "type": "stdio",
23
+ "command": "npx",
24
+ "args": ["-y", "skillsmp-mcp-lite"],
25
+ "env": {
26
+ "SKILLSMP_API_KEY": "YOUR_API_KEY"
41
27
  }
42
28
  }
43
29
  }
44
30
  }
45
31
  ```
46
32
 
47
- ### Claude Desktop Setup
33
+ ### Cursor
48
34
 
49
- Add to your `claude_desktop_config.json`:
35
+ Add to `~/.cursor/mcp.json`:
50
36
 
51
37
  ```json
52
38
  {
53
39
  "mcpServers": {
54
40
  "skillsmp": {
55
- "command": "node",
56
- "args": ["/absolute/path/to/skillsmp-mcp-server/dist/index.js"],
41
+ "command": "npx",
42
+ "args": ["-y", "skillsmp-mcp-lite"],
57
43
  "env": {
58
- "SKILLSMP_API_KEY": "sk_live_skillsmp_YOUR_API_KEY"
44
+ "SKILLSMP_API_KEY": "YOUR_API_KEY"
59
45
  }
60
46
  }
61
47
  }
62
48
  }
63
49
  ```
64
50
 
65
- ## Available Tools
66
-
67
- ### `skillsmp_search_skills`
51
+ ### Claude Desktop
68
52
 
69
- Search for skills using keywords.
53
+ Add to your `claude_desktop_config.json`:
70
54
 
71
- **Parameters:**
55
+ - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
56
+ - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
72
57
 
73
- - `query` (string, required): Search keywords
74
- - `page` (number, optional): Page number (default: 1)
75
- - `limit` (number, optional): Items per page (default: 20, max: 100)
76
- - `sortBy` (string, optional): Sort by "stars" or "recent"
58
+ ```json
59
+ {
60
+ "mcpServers": {
61
+ "skillsmp": {
62
+ "command": "npx",
63
+ "args": ["-y", "skillsmp-mcp-lite"],
64
+ "env": {
65
+ "SKILLSMP_API_KEY": "YOUR_API_KEY"
66
+ }
67
+ }
68
+ }
69
+ }
70
+ ```
77
71
 
78
- **Example:**
72
+ ### Claude Code
79
73
 
80
- ```
81
- Search for "PDF manipulation" skills
74
+ ```bash
75
+ claude mcp add skillsmp -- npx -y skillsmp-mcp-lite --env SKILLSMP_API_KEY=YOUR_API_KEY
82
76
  ```
83
77
 
84
- ### `skillsmp_ai_search_skills`
78
+ ## Get Your API Key
85
79
 
86
- AI semantic search for skills using natural language.
80
+ Get your API key from: https://skillsmp.com/docs/api
87
81
 
88
- **Parameters:**
82
+ > **Note**: The API key is optional. Without it, you may encounter rate limits.
89
83
 
90
- - `query` (string, required): Natural language description of what you want to accomplish
84
+ ## Available Tools
91
85
 
92
- **Example:**
86
+ ### `skillsmp_search_skills`
93
87
 
94
- ```
95
- Find skills for "How to create a web scraper that extracts product data"
96
- ```
88
+ Search for skills using keywords.
89
+
90
+ | Parameter | Type | Required | Description |
91
+ |-----------|------|----------|-------------|
92
+ | `query` | string | Yes | Search keywords |
93
+ | `page` | number | No | Page number (default: 1) |
94
+ | `limit` | number | No | Items per page (default: 20, max: 100) |
95
+ | `sortBy` | string | No | Sort by "stars" or "recent" |
97
96
 
98
- ## Usage Workflow
97
+ ### `skillsmp_ai_search_skills`
99
98
 
100
- The recommended workflow is:
99
+ AI semantic search for skills using natural language.
101
100
 
102
- 1. **Before starting any task**, search for relevant skills
103
- 2. If a matching skill is found, use `npx openskills read <skill-name>` to load it
104
- 3. Follow the skill's instructions to complete the task
101
+ | Parameter | Type | Required | Description |
102
+ |-----------|------|----------|-------------|
103
+ | `query` | string | Yes | Natural language description |
105
104
 
106
- ## API Reference
105
+ ## Usage Examples
107
106
 
108
- This server uses the SkillsMP REST API:
107
+ Ask your AI assistant:
109
108
 
110
- - `GET /api/v1/skills/search` - Keyword search
111
- - `GET /api/v1/skills/ai-search` - AI semantic search
109
+ - "Search for PDF manipulation skills"
110
+ - "Find skills for building a web scraper"
111
+ - "What skills can help me with SEO optimization?"
112
112
 
113
113
  ## License
114
114
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skillsmp-mcp-lite",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "Lightweight MCP server for searching AI skills from SkillsMP before starting any task",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",