@skillsmith/mcp-server 0.3.9 → 0.3.11
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.
package/README.md
CHANGED
|
@@ -36,16 +36,71 @@ Claude will automatically update your `~/.claude/settings.json`. After restartin
|
|
|
36
36
|
|
|
37
37
|
## Live Skill Registry
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
The Skillsmith API provides access to **14,000+ skills** that are:
|
|
40
40
|
|
|
41
|
-
|
|
41
|
+
- **Indexed daily** from GitHub repositories
|
|
42
|
+
- **Security screened hourly** for vulnerabilities and malicious patterns
|
|
43
|
+
- **Quality scored** based on documentation, structure, and community feedback
|
|
44
|
+
- **Categorized** by trust tier (Verified, Community, Experimental)
|
|
42
45
|
|
|
43
46
|
Skills are served from `api.skillsmith.app` and cached locally for 24 hours.
|
|
44
47
|
|
|
48
|
+
> **Note (v0.3.8):** Fixed critical bug where the MCP server defaulted to offline mode for all users. Search now correctly connects to the production API. See [SMI-1948](https://linear.app/smith-horn-group/issue/SMI-1948).
|
|
49
|
+
|
|
50
|
+
### Why Configure an API Key?
|
|
51
|
+
|
|
52
|
+
Without an API key, you're limited to **10 total requests** (trial mode). With a free Community account, you get **30 requests/minute** with access to all live skills.
|
|
53
|
+
|
|
54
|
+
**Benefits of API key:**
|
|
55
|
+
- Access to live indexed skills (not just cached)
|
|
56
|
+
- Higher rate limits based on your tier
|
|
57
|
+
- Usage tracking on your dashboard
|
|
58
|
+
- Priority during high-traffic periods
|
|
59
|
+
|
|
60
|
+
### API Key Configuration (SMI-1953)
|
|
61
|
+
|
|
62
|
+
**Step 1:** Get your API key from https://skillsmith.app/account
|
|
63
|
+
|
|
64
|
+
**Step 2:** Add to your Claude settings at `~/.claude/settings.json`:
|
|
65
|
+
|
|
66
|
+
```json
|
|
67
|
+
{
|
|
68
|
+
"mcpServers": {
|
|
69
|
+
"skillsmith": {
|
|
70
|
+
"command": "npx",
|
|
71
|
+
"args": ["-y", "@skillsmith/mcp-server"],
|
|
72
|
+
"env": {
|
|
73
|
+
"SKILLSMITH_API_KEY": "sk_live_your_key_here"
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
**Step 3:** Restart Claude Code (Cmd/Ctrl+Shift+P → "Claude Code: Restart")
|
|
81
|
+
|
|
82
|
+
> **Security Note:** Never paste your API key in chat. Configure it via the settings file above, then reference it via `$SKILLSMITH_API_KEY` in commands. See [SMI-1956](https://linear.app/smith-horn-group/issue/SMI-1956).
|
|
83
|
+
|
|
84
|
+
### Rate Limits by Tier
|
|
85
|
+
|
|
86
|
+
| Tier | Rate Limit | Monthly Cost | Best For |
|
|
87
|
+
|------|------------|--------------|----------|
|
|
88
|
+
| Trial | 10 total | Free | Quick evaluation |
|
|
89
|
+
| Community | 30/min | Free | Personal projects |
|
|
90
|
+
| Individual | 60/min | $9.99/mo | Active developers |
|
|
91
|
+
| Team | 120/min | $25/user/mo | Development teams |
|
|
92
|
+
| Enterprise | 300/min | $55/user/mo | Large organizations |
|
|
93
|
+
|
|
94
|
+
All tiers include:
|
|
95
|
+
- Full access to skill search, details, and recommendations
|
|
96
|
+
- Security screening results
|
|
97
|
+
- Quality scores and trust tier information
|
|
98
|
+
|
|
45
99
|
### API Configuration
|
|
46
100
|
|
|
47
101
|
| Variable | Default | Description |
|
|
48
102
|
|----------|---------|-------------|
|
|
103
|
+
| `SKILLSMITH_API_KEY` | - | Personal API key for usage tracking |
|
|
49
104
|
| `SKILLSMITH_API_URL` | `https://api.skillsmith.app/functions/v1` | API endpoint |
|
|
50
105
|
| `SKILLSMITH_OFFLINE_MODE` | `false` | Use local database instead |
|
|
51
106
|
| `SKILLSMITH_TELEMETRY` | `true` | Enable anonymous telemetry |
|