skills-mcp-server
skills-mcp
Ein leistungsstarker MCP-Server (Model Context Protocol), der einen Katalog von über 1300 KI-Skills durch BM25-gerankte Suche, strukturierte Metadaten und kontext-effiziente Antworten bereitstellt.
Entwickelt, um ein Problem zu lösen: Tausende von Skills zerstören Ihr Kontextfenster. Dieser Server indiziert sie, bewertet sie und liefert nur das, was Sie benötigen.
┌────────────────────────────────────────────────────────────┐
│ IDE / AI Client │
│ (Claude, Cursor, Gemini, Copilot, Windsurf, ...) │
│ │
│ "find me a skill for React dashboards" │
└──────────────────────┬─────────────────────────────────────┘
│ MCP Protocol
▼
┌────────────────────────────────────────────────────────────┐
│ skills-mcp │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ Indexer │ │ BM25 │ │ 6 MCP │ │
│ │ 1300+ │──│ Search │──│ Tools │ │
│ │ skills │ │ Engine │ │ │ │
│ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ Transports: stdio | HTTP/SSE | AWS Lambda │
└────────────────────────────────────────────────────────────┘Funktionen
BM25-gerankte Suche — Kein einfaches Keyword-Matching. Echte Relevanzbewertung mit Feldgewichtung (Name 3x, Beschreibung 2x, Tags 2x, Inhalt 1x)
Kontext-effizient — Lesen Sie Skill-Metadaten (~500 Zeichen), Zusammenfassungen (~2K Zeichen) oder den vollständigen Inhalt (begrenzt auf 25K Zeichen). Sie steuern, wie viel Kontext verbraucht wird
Strukturierte Metadaten — YAML-Frontmatter, geparst in typisierte Felder: Name, Beschreibung, Tags, Kategorie, Risiko, Autor, Tools
Überall Paginierung — Jedes Listen-/Such-Tool unterstützt
offsetundlimit3 Transportmodi — stdio für lokale IDEs, HTTP/SSE für Fernzugriff, AWS Lambda für Serverless
Schneller Start — Über 1300 Skills in ~1,5 Sekunden indiziert. ~3MB Speicherbedarf (im Vergleich zu 65MB roh)
6 spezialisierte Tools — Durchsuchen, Auflisten, Suchen, Lesen, Inspizieren, Aktualisieren
Related MCP server: skilldb-mcp
Schnellstart
Voraussetzungen
Node.js 18+
Das
skills/-Verzeichnis mit SKILL.md-Dateien (siehe Skill-Format)
Installation & Build
git clone https://github.com/LucasRomanzin/skills-mcp.git
cd skills-mcp
npm install
npm run buildLokal ausführen (stdio)
node dist/index.jsAls HTTP-Server ausführen (SSE)
node dist/http.js
# Server starts on http://localhost:3000
# MCP endpoint: http://localhost:3000/mcp
# Health check: http://localhost:3000/healthMCP-Tools
skills_browse_categories
Listet alle Skill-Kategorien mit Anzahl auf. Verwenden Sie dies zuerst.
Input: { response_format?: "markdown" | "json" }
Output: Table with 9 categories and skill countsskills_search
BM25-gerankte Volltextsuche über Namen, Beschreibungen, Tags und Inhalte.
Input: { query: string, category?: string, risk?: string, offset?: 0, limit?: 10 }
Output: Ranked results with name, description, category, tags, scoreskills_list_by_category
Listet Skills innerhalb einer bestimmten Kategorie mit Paginierung auf.
Input: { category: string, offset?: 0, limit?: 20 }
Output: Paginated skill list with metadataskills_read
Liest Skill-Inhalte mit Kontextsteuerung.
Input: { slug: string, section?: "metadata" | "summary" | "full", file?: string }
section="metadata" → ~500 chars (frontmatter fields + file list)
section="summary" → ~2500 chars (metadata + first 2000 chars of body)
section="full" → up to 25000 chars (complete content, truncated if larger)skills_inspect
Ruft strukturierte Metadaten für mehrere Skills ab + verwandte Skills durch Tag-Überschneidungen.
Input: { slugs: string[] (1-10), response_format?: "json" }
Output: Metadata + related_skills for each slugskills_refresh_index
Erstellt den In-Memory-Index neu, nachdem Skills auf der Festplatte hinzugefügt, entfernt oder geändert wurden.
Input: {}
Output: Previous count, new count, durationIDE-Konfiguration
Claude Desktop / Claude Code
{
"mcpServers": {
"skills": {
"command": "node",
"args": ["/path/to/skills-mcp/dist/index.js"],
"env": {
"SKILLS_DIR": "/path/to/skills-mcp/skills"
}
}
}
}Remote (HTTP/SSE) — Cursor, VS Code, jeder MCP-Client
{
"mcpServers": {
"skills": {
"url": "http://localhost:3000/mcp"
}
}
}AWS Lambda (nach dem Deployment)
{
"mcpServers": {
"skills": {
"url": "https://<function-url-id>.lambda-url.<region>.on.aws/mcp"
}
}
}Siehe docs/SETUP.md für vollständige Schritt-für-Schritt-Anleitungen für alle Modi und IDEs.
Deployment-Modi
Modus | Befehl | Anwendungsfall | SSE-Streaming |
stdio |
| Lokale IDEs (Claude, Cursor, Gemini CLI) | N/A |
HTTP |
| Dev-Server, EC2, VPS, Docker | Ja |
Lambda | SAM deploy | Serverless, Auto-Scaling, nutzungsbasierte Abrechnung | Ja (Response-Streaming) |
Skill-Format
Jeder Skill ist ein Verzeichnis unter skills/, das mindestens eine SKILL.md-Datei mit YAML-Frontmatter enthält:
skills/
├── CATALOG.md # Category-to-skill mapping (auto-generated)
├── my-skill/
│ ├── SKILL.md # Required: frontmatter + content
│ ├── references/ # Optional: additional .md files
│ └── scripts/ # Optional: helper scriptsSKILL.md-Struktur
---
name: my-skill
description: What this skill does in one sentence.
tags:
- react
- dashboard
- frontend
risk: safe
source: community
author: your-name
tools:
- claude-code
- cursor
---
# My Skill
## Overview
...
## When to Use This Skill
...Frontmatter-Felder
Feld | Typ | Erforderlich | Beschreibung |
| string | Ja | Skill-Bezeichner |
| string | Ja | Einzeilige Beschreibung |
| string[] | Nein | Suchbare Schlüsselwörter |
| enum | Nein |
|
| string | Nein | Herkunft ( |
| string | Nein | Name des Erstellers |
| string[] | Nein | Kompatible KI-Tools |
Architektur
src/
├── index.ts # stdio entry point
├── http.ts # Express HTTP/SSE entry point
├── lambda.ts # AWS Lambda handler
├── server.ts # McpServer factory (shared)
├── constants.ts # CHARACTER_LIMIT, pagination defaults
├── types.ts # TypeScript interfaces
├── indexer.ts # Frontmatter parser + skill index builder
├── catalog.ts # CATALOG.md parser → category mapping
├── search.ts # BM25 scoring engine
├── tools/
│ ├── browse.ts # skills_browse_categories
│ ├── list.ts # skills_list_by_category
│ ├── search.ts # skills_search
│ ├── read.ts # skills_read
│ ├── inspect.ts # skills_inspect
│ └── refresh.ts # skills_refresh_index
└── utils/
├── frontmatter.ts # gray-matter wrapper + tag normalization
├── format.ts # Markdown/JSON response formatters
├── truncate.ts # CHARACTER_LIMIT enforcement
└── paginate.ts # Generic paginationSuchmaschine
Die BM25-Implementierung indiziert jeden Skill als gewichtetes Dokument:
Feld | Gewichtung | Beispiel |
| 3x | "react-patterns" 3-mal wiederholt |
| 2x | "Modern React patterns..." 2-mal wiederholt |
| 2x | "react frontend hooks" 2-mal wiederholt |
| 1x | "development" |
| 1x | Erste 500 Zeichen des Inhalts |
Die Bewertung verwendet BM25 mit k1=1.5, b=0.75. Die Ergebnisse werden nach absteigendem Relevanz-Score sortiert.
Leistung: Die Suche über 1300+ Skills erfolgt in <10ms.
Umgebungsvariablen
Variable | Standardwert | Beschreibung |
|
| Pfad zum Skills-Verzeichnis |
|
| HTTP-Server-Port (nur http.ts) |
Tech-Stack
TypeScript — Strict Mode, ESM
MCP SDK v1.29+ —
StreamableHTTPServerTransport,WebStandardStreamableHTTPServerTransportgray-matter — YAML-Frontmatter-Parsing
Zod — Eingabevalidierungsschemata
BM25 — Eigene Implementierung (~80 Zeilen), null externe Abhängigkeiten
Lizenz
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Capability registry for the agentic economy. Semantic search over verified MCP server listings.
Hosted MCP server for live public-data APIs and Skills for AI agents.
Find the right MCP server or skill for a task: ranked, install-ready results from 50K+ servers.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Related MCP Servers
- AlicenseAqualityDmaintenanceThis MCP server enables AI agents to search, discover, and install skills from the SkillsMP marketplace, with support for keyword and semantic search, skill content retrieval, and installation to various coding agents.517 npm3MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for SkillDB that enables AI assistants to search, load, and manage AI agent skills directly.389 npm2MIT
- AlicenseAqualityDmaintenanceAn MCP server that provides on-demand skill discovery for AI coding agents by querying GitHub repositories, using BM25 search to return relevant SKILL.md content.213 npmMIT
- FlicenseNot gradedqualityDmaintenanceA hierarchical MCP server for managing skill definitions with a browsable tree structure and full-text search. It allows AI agents to efficiently discover and use skills without consuming context tokens.-