# SkillsMP MCP Server

A Model Context Protocol (MCP) server that enables AI agents to search, discover, and install skills from the [SkillsMP](https://skillsmp.com) marketplace.

## Features

| Tool | Description |
|------|-------------|
| `skillsmp_search` | Search skills by keywords with pagination and sorting |
| `skillsmp_ai_search` | AI-powered semantic search using natural language |
| `skillsmp_get_skill_content` | Read skill content (SKILL.md) from GitHub |
| `skillsmp_list_repo_skills` | List available skills in a repository |
| `skillsmp_install_skill` | Install skills to AI coding agents |

## Requirements

- Node.js 18+
- SkillsMP API key ([Get one here](https://skillsmp.com))

## Setup

### Claude Code

```bash
claude mcp add skillsmp -- npx -y skillsmp-mcp-server --env SKILLSMP_API_KEY=your_api_key
```

### Cursor

Add to your Cursor MCP configuration (`~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "skillsmp": {
      "command": "npx",
      "args": ["-y", "skillsmp-mcp-server"],
      "env": {
        "SKILLSMP_API_KEY": "your_api_key"
      }
    }
  }
}
```

### Claude Desktop

Add to your Claude Desktop configuration:

**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "skillsmp": {
      "command": "npx",
      "args": ["-y", "skillsmp-mcp-server"],
      "env": {
        "SKILLSMP_API_KEY": "your_api_key"
      }
    }
  }
}
```

### Opencode

Add to your Opencode configuration:

```json
{
  "mcp": {
    "skillsmp": {
      "type": "local",
      "command": ["npx", "-y", "skillsmp-mcp-server"],
      "env": {
        "SKILLSMP_API_KEY": "your_api_key"
      },
      "enabled": true
    }
  }
}
```

### Google Antigravity

Add to your Antigravity MCP configuration:

```json
{
  "mcpServers": {
    "skillsmp": {
      "command": "npx",
      "args": ["-y", "skillsmp-mcp-server"],
      "env": {
        "SKILLSMP_API_KEY": "your_api_key"
      }
    }
  }
}
```

### Roo Code

Add to your Roo Code MCP settings:

```json
{
  "mcpServers": {
    "skillsmp": {
      "command": "npx",
      "args": ["-y", "skillsmp-mcp-server"],
      "env": {
        "SKILLSMP_API_KEY": "your_api_key"
      }
    }
  }
}
```

### GitHub Copilot

Add to your Copilot MCP configuration:

```json
{
  "mcpServers": {
    "skillsmp": {
      "command": "npx",
      "args": ["-y", "skillsmp-mcp-server"],
      "env": {
        "SKILLSMP_API_KEY": "your_api_key"
      }
    }
  }
}
```

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `SKILLSMP_API_KEY` | Yes | Your SkillsMP API key |
| `TRANSPORT` | No | Transport type: `stdio` (default) or `http` |
| `PORT` | No | HTTP port when using http transport (default: 3000) |

## Usage

Once configured, the MCP server tools become available to your AI assistant.

### Search Skills

```
Search for Python skills sorted by stars
```

### AI Semantic Search

```
Find skills that help with building REST APIs with authentication
```

### List Repository Skills

```
What skills are available in anthropics/claude-code?
```

### Install Skills

```
Install the frontend-design skill from anthropics/claude-code to Claude Code
```

## API Reference

### skillsmp_search

Search skills by keywords.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `query` | string | Yes | - | Search keywords |
| `page` | number | No | 1 | Page number |
| `limit` | number | No | 20 | Results per page (max: 100) |
| `sort_by` | string | No | stars | Sort by `stars` or `recent` |

### skillsmp_ai_search

AI-powered semantic search using natural language.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Natural language query |

### skillsmp_get_skill_content

Read skill content from GitHub repository.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `owner` | string | Yes | - | GitHub username/org |
| `repo` | string | Yes | - | Repository name |
| `path` | string | No | - | Path to skill folder |
| `branch` | string | No | main | Git branch |

### skillsmp_list_repo_skills

List all skills in a repository.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source` | string | Yes | GitHub `owner/repo` |

### skillsmp_install_skill

Install skills to AI coding agents.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `source` | string | Yes | - | GitHub `owner/repo` |
| `skills` | string | Yes | - | Skill names (comma-separated) |
| `agents` | string | Yes | - | Target agents (comma-separated) |
| `global` | boolean | No | false | Install user-level instead of project-level |

**Supported Agents:** `claude-code`, `cursor`, `codex`, `opencode`, `antigravity`, `github-copilot`, `roo`

## HTTP Transport

For remote deployments or multi-client scenarios:

```bash
SKILLSMP_API_KEY="your_api_key" TRANSPORT=http PORT=3000 npx skillsmp-mcp-server
```

## Development

### From Source

```bash
git clone https://github.com/anilcancakir/skillsmp-mcp-server.git
cd skillsmp-mcp-server
npm install
npm run build
npm run dev
```

### Running Tests

```bash
npm run test:run
```

## License

MIT License - see [LICENSE](LICENSE) for details.

## Links

- [SkillsMP Marketplace](https://skillsmp.com)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)

---

Built with the [Model Context Protocol](https://modelcontextprotocol.io) TypeScript SDK.