Skill-to-MCP

[][tests] [][documentation] [][pypi] [][pypi]

Convert AI Skills (following Claude Skills format) into MCP server resources, making them accessible through the Model Context Protocol.

Part of BioContextAI - A community-driven initiative connecting agentic AI with biomedical resources through standardized MCP servers. While this package is domain-agnostic and can be used for any skill collection, it was developed to support the biomedical research community.

Overview

This MCP server exposes Claude Skills as resources that can be accessed by LLM applications through the Model Context Protocol. Skills are self-contained directories containing a SKILL.md file with YAML frontmatter, along with supporting files like scripts, references, and examples.

Features

• Automatic skill discovery: Recursively finds all SKILL.md files in the skills/ directory
• Frontmatter parsing: Extracts skill metadata (name, description) from YAML frontmatter
• Three core tools:
  • get_available_skills: Lists all available skills with descriptions
  • get_skill_details: Returns SKILL.md content and file listing for a specific skill
  • get_skill_related_file: Reads any file within a skill directory (with directory traversal protection)
• Security: Path validation prevents access outside skill directories

Getting Started

Please refer to the [documentation][] for comprehensive guides, or jump to:

• Configuration - Set up your skills directory
• Usage - Learn about the three core tools
• Creating Skills - Build your own skills
• Installation - Multiple installation options

Quick Links

• Documentation: [skill-to-mcp.readthedocs.io][documentation]
• BioContextAI Registry: [biocontext.ai/registry][registry]
• API Reference: [API documentation][]
• Source Code: [GitHub][source]
• Issue Tracker: [GitHub Issues][issue tracker]

Configuration

The MCP server requires a skills directory to be specified. This allows you to:

• Install the package separately from your skills
• Edit skills without modifying the package
• Use different skill collections for different projects

Set the skills directory using either:

• Command-line option: --skills-dir /path/to/skills
• Environment variable: SKILLS_DIR=/path/to/skills

Example Configuration for MCP Clients

{
  "mcpServers": {
    "skill-to-mcp": {
      "command": "uvx",
      "args": ["skill_to_mcp", "--skills-dir", "/path/to/your/skills"],
      "env": {
        "UV_PYTHON": "3.12"
      }
    }
  }
}

Or using environment variables:

{
  "mcpServers": {
    "skill-to-mcp": {
      "command": "uvx",
      "args": ["skill_to_mcp"],
      "env": {
        "UV_PYTHON": "3.12",
        "SKILLS_DIR": "/path/to/your/skills"
      }
    }
  }
}

Usage

Once configured in your MCP client, the server provides three tools:

get_available_skills

Returns a list of all available skills with metadata:

[
  {
    "name": "single-cell-rna-qc",
    "description": "Performs quality control on single-cell RNA-seq data...",
    "path": "/path/to/skills/single-cell-rna-qc"
  }
]

get_skill_details

Returns the full SKILL.md content and list of files for a specific skill:

{
  "skill_content": "---\nname: single-cell-rna-qc\n...",
  "files": 

... [View full README on GitHub](https://github.com/biocontext-ai/skill-to-mcp#readme)