npm package: @quickcreator/skill-mcp
Description: MCP server for QuickCreator skill authoring and marketplace version management
Author: QuickCreator
Latest version: 0.1.3

# @quickcreator/skill-mcp

MCP (Model Context Protocol) server for QuickCreator skill authoring and marketplace version management.

## Setup

### 1. Get an API Token

Generate a token via the QuickCreator API:

```bash
curl -X POST https://api.quickcreator.io/ai-blog-chat-service/tokens \
  -H "x-token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "my-mcp-token", "scopes": "read,write,publish"}'
```

### 2. Configure in Cursor / Claude Desktop

Add to your MCP config (`~/.cursor/mcp.json` or Claude Desktop config):

```json
{
  "mcpServers": {
    "quickcreator-skill": {
      "command": "npx",
      "args": ["@quickcreator/skill-mcp"],
      "env": {
        "QC_API_TOKEN": "qct_your_token_here"
      }
    }
  }
}
```

`QC_API_URL` defaults to `https://api.quickcreator.io/ai-blog-chat-service`. Override it for self-hosted or development environments.

## Available Tools

| Tool | Description |
|------|-------------|
| `list_personal_skills` | List team personal skill workspaces |
| `list_builtin_skills` | List platform builtin skills |
| `list_marketplace_skills` | List public marketplace packages |
| `search_marketplace` | Search marketplace by tag, sorted by publish time or downloads |
| `get_skill_tree` | Get skill detail and full file tree |
| `get_skill_file` | Read a specific file from any skill |
| `get_marketplace_skill_detail` | Get marketplace package detail and latest version info |
| `create_personal_skill` | Create a new empty team personal skill |
| `fork_skill_to_personal` | Fork a builtin or marketplace skill to personal |
| `update_personal_skill_file` | Update a file in a personal skill |
| `create_personal_skill_file` | Add a new file to a personal skill |
| `delete_personal_skill_file` | Delete a single file in a personal skill |
| `delete_personal_skill` | Delete a personal skill |
| `publish_skill_version` | Create a new marketplace package or publish a new version |
| `list_published_skill_versions` | List all versions for a marketplace package |
| `set_marketplace_latest_version` | Switch which published version is latest |
| `deprecate_skill_version` | Deprecate a published version |

## Root `manifest.json` Support

When `create_skill_file` or `update_skill_file` targets the root-level `manifest.json`, the MCP does not upload it as a normal skill file.

Instead, it parses `manifest.json` and sends `manifest.config` to the backend as the skill root's `envSchema`, which is then copied through publish/update flows for marketplace install-time configuration.

## Skill ID Prefixes

- `sk_` — Built-in skills (read-only, admin-managed)
- `mk_` — Marketplace skills (published by users)
- `p_` — Team personal skills (editable workspace)

This MCP is authoring-only. It does not expose runtime install / uninstall tools.

## Workflow

```
1. Browse:      list_marketplace_skills()
2. Fork:        fork_skill_to_personal(skillId="mk_xxx", source="marketplace")
3. Develop:     create_personal_skill_file / update_personal_skill_file / delete_personal_skill_file
4. Publish:     publish_skill_version(personalSkillId="p_xxx")
5. Iterate:     publish_skill_version(personalSkillId="p_xxx", marketplaceSkillId="mk_xxx")
6. Manage:      list_published_skill_versions / set_marketplace_latest_version
```

## Development

```bash
npm install
npm run build
npm start
```

## License

MIT