Skills MCP

v1.0.0Developer Toolsstable

A high-performance MCP server that provides BM25-ranked search and structured access to over 1,300 AI skills, enabling context-efficient discovery and usage of AI capabilities while minimizing token consumption.

agent-skillsagentsazurefoundrymcp
Share:
2,365
Stars
0
Downloads
0
Weekly
0/5

What is Skills MCP?

Skills MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to high-performance mcp server that provides bm25-ranked search and structured access to over 1,300 ai skills, enabling context-efficient discovery and usage of ai capabilities while minimizing token con...

A high-performance MCP server that provides BM25-ranked search and structured access to over 1,300 AI skills, enabling context-efficient discovery and usage of AI capabilities while minimizing token consumption.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A high-performance MCP server that provides BM25-ranked sear

Use Cases

High-performance discovery of 1,300+ AI skills
BM25-ranked search with token efficiency
amazingashis

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx skills

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Skills MCP

The Skills MCP server provides BM25-ranked search and structured access to a large library of AI agent skills, enabling AI clients to efficiently discover and invoke reusable capability definitions without loading all skill content into context at once. It exposes tools to list, search, and retrieve individual skill documents stored as SKILL.md files in a local directory tree. This approach is token-efficient by design — agents only load the skills they need, making it well-suited for large skill libraries in Azure AI Foundry and similar agent platforms.

Prerequisites

  • Node.js 18 or higher installed
  • A directory of skill packs containing SKILL.md files (SKILLS_ROOT)
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with MCP support
  • Git for cloning the repository and building locally
1

Clone and build the server

Clone the skills-mcp-server repository and build the TypeScript source to produce the runnable dist/main.js file.

git clone https://github.com/amazingashis/mcp-deployment.git
cd mcp-deployment
npm install
npm run build
2

Prepare your skills directory

Create a directory containing your skill packs. Each skill should be a subdirectory with a SKILL.md file describing the skill's capabilities, parameters, and usage. Set the SKILLS_ROOT environment variable to point to this directory.

mkdir -p ~/my-skills/web-search
# Place SKILL.md files in subdirectories
3

Run the server locally

Start the MCP server in stdio mode by running the compiled JavaScript file with the SKILLS_ROOT environment variable set.

SKILLS_ROOT=/path/to/your/skills node /path/to/dist/main.js
4

Configure your MCP client

Add the skills server to your MCP client configuration file, pointing to the built dist/main.js and your skills directory.

{
  "mcpServers": {
    "skills": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-deployment/dist/main.js"],
      "env": {
        "SKILLS_ROOT": "/absolute/path/to/your/skills"
      }
    }
  }
}
5

Use the exposed tools in your AI client

The server exposes three tools: list_skills (enumerate all available skill packs), search_skills (BM25-ranked keyword search), and get_skill (retrieve a specific skill's full content by ID). Skills are also accessible as resources at skills://skill/{skillId}.

Skills MCP Examples

Client configuration

MCP client configuration for the skills server pointing to a local skills directory.

{
  "mcpServers": {
    "skills": {
      "command": "node",
      "args": ["/home/user/mcp-deployment/dist/main.js"],
      "env": {
        "SKILLS_ROOT": "/home/user/my-skills"
      }
    }
  }
}

Prompts to try

Example prompts for discovering and using AI skills through the skills MCP server.

- "List all available skills in the library."
- "Search for skills related to web scraping."
- "Get the full details of the 'data-extraction' skill."
- "What skills are available for working with databases?"
- "Find skills that can help me process CSV files."

Troubleshooting Skills MCP

Server starts but list_skills returns empty results

Verify that SKILLS_ROOT points to a directory containing subdirectories with SKILL.md files. The server expects each skill to be a folder with a SKILL.md file inside — bare .md files at the root level are not picked up.

Module not found errors when running dist/main.js

Run 'npm install' and 'npm run build' again from the repository root. Ensure you are using the correct absolute path to dist/main.js in your MCP config — relative paths may not resolve correctly from the MCP client's working directory.

search_skills returns irrelevant results

BM25 search is keyword-based — use specific technical terms from your SKILL.md file names and content. Ensure SKILL.md files contain descriptive titles and keyword-rich descriptions for best search accuracy.

Frequently Asked Questions about Skills MCP

What is Skills MCP?

Skills MCP is a Model Context Protocol (MCP) server that high-performance mcp server that provides bm25-ranked search and structured access to over 1,300 ai skills, enabling context-efficient discovery and usage of ai capabilities while minimizing token consumption. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Skills MCP?

Follow the installation instructions on the Skills MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Skills MCP?

Skills MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Skills MCP free to use?

Yes, Skills MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "skills": { "command": "npx", "args": ["-y", "skills"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Skills MCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides