qingkuai-mcp-server

qingkuai-mcp-server

MCP server for Qingkuai — provides AI agents with syntax documentation search, syntax checking, compilation, and code formatting tools for .qk files.

Tools

Tool	Description
search_qingkuai_docs	Search official Qingkuai syntax/reference docs. Always call this before falling back to website search.
check_qingkuai_syntax	Validate .qk source code syntax (template structure, script errors, directive usage) without full compilation.
compile_qingkuai	Compile .qk source to JavaScript with source maps.
format_qingkuai_code	Format a .qk file using Prettier with the Qingkuai plugin and write back to disk.

Prompts

Prompt	Trigger scenario
qingkuai-code-generation-rules	Generating or editing .qk files — enforces reference attribute priority, reactive declaration minimization, and naming conventions.
qingkuai-install-init-create-qingkuai-first	Installing, initializing, or scaffolding a Qingkuai project — enforces create-qingkuai usage.

Usage

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "qingkuai": {
      "command": "npx",
      "args": ["qingkuai-mcp-server"]
    }
  }
}

VS Code (Copilot Agent Mode)

Add to your .vscode/mcp.json:

{
  "servers": {
    "qingkuai": {
      "command": "npx",
      "args": ["qingkuai-mcp-server"],
      "type": "stdio"
    }
  }
}

Direct execution

npx qingkuai-mcp-server

Requirements

• Node.js ≥ 18
• A Qingkuai project (see Getting Started)

License

MIT