Skip to main content
Glama

Skills MCP

PyPI version License Python Versions

The Package Manager for AI Agents.

Skills MCP connects your LLM Agent (like Claude Desktop or Claude Code) to a global registry of capabilities. It allows your Agent to autonomously discover, install, and learn new skills to solve complex tasks.

Thin MCP, Fat Agent Philosophy: This tool handles the delivery of code and instructions, empowering the Agent to execute them using its own environment (e.g., uv, bash).


🚀 Features

  • Search: Find skills for specific tasks (e.g., "pdf", "excel", "diagram").

  • Install: One-click download and installation to your local machine (~/.skills).

  • Learn: Provides the Agent with the exact file structure and SKILL.md instructions.

  • Dependency Management: Works seamlessly with uv to let Agents self-manage Python environments without polluting your system.


📦 Installation

The recommended way to install is via uv (a fast Python package manager). It ensures the tool runs in an isolated environment.

Prerequisites

  • Python 3.10+

  • uv (Recommended)

# 1. Install uv (if you haven't already) curl -LsSf https://astral.sh/uv/install.sh | sh # 2. Install Skills MCP globally uv tool install skills-mcp

(Alternatively, you can use


⚙️ Configuration

🖥️ Claude Desktop (GUI)

To use Skills MCP with the Claude Desktop app, update your configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following entry:

{ "mcpServers": { "skills": { "command": "uv", "args": ["tool", "run", "skills-mcp"], "env": { "SKILLS_ROOT": "/Users/YOUR_USERNAME/.skills", "SKILLS_REGISTRY_URL": "https://skills.leezhu.cn/api/v1" } } } }

Tip: Replace

⌨️ Claude Code (CLI)

If you are using the claude command-line tool, you can install the MCP server directly via the CLI:

# Add the MCP server claude mcp add skills -- uv tool run skills-mcp

Note on Configuration: Claude Code inherits environment variables from your shell. To set custom configurations (like a private registry URL), export them in your shell profile (~/.zshrc or ~/.bashrc):

export SKILLS_REGISTRY_URL="https://your-private-registry.com/api/v1"

Environment Variables

Variable

Description

Default

SKILLS_ROOT

Where skills are installed locally.

~/.skills

SKILLS_REGISTRY_URL

The API endpoint of the skills registry.

https://skills.leezhu.cn/api/v1

SKILLS_API_KEY

(Optional) Token for private registries.

None


💡 Usage Guide (for Agents)

Once installed, you can ask Claude to do things like:

  1. Discovery:

    "Search for a skill that can split Excel files." (Claude calls

  2. Acquisition:

    "Install the excel-pro skill." (Claude calls

  3. Execution:

    "Read the instructions for excel-pro and split this file." (Claude calls


🛠️ Development

Setup

git clone https://github.com/leezhuuuuu/skills-mcp.git cd skills-mcp # Install dependencies uv sync

Running Locally (StdIO Mode)

# Direct run uv run skills-mcp

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

  1. Fork the repository.

  2. Create your feature branch.

  3. Commit your changes.

  4. Push to the branch.

  5. Open a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

One-click Deploy
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/leezhuuuuu/skills-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server