# qingkuai-mcp-server [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/qingkuai-js/language-features  
**GitHub Stars:** 3  
**npm Downloads (last month):** 203  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/qingkuai-mcp-server

## Description
MCP server for Qingkuai (.qk) — docs search, syntax check, compilation, and formatting tools.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "qingkuai-mcp-server": {
    "url": "https://marketplace.visualstudio.com/items?itemName=qingkuai-tools.qingkuai-language-features"
  }
}
```

## Documentation & README

# Qingkuai Language Features

Qingkuai Language Features is the official language tooling workspace for QingKuai files (`.qk`).

It contains the full toolchain used by the VS Code extension, including:

- language grammar and syntax highlighting
- language service (analysis, completion, formatting, diagnostics)
- language server (LSP)
- TypeScript plugin integration

## Workspace Packages

| Package                      | Description                                                |
| ---------------------------- | ---------------------------------------------------------- |
| `packages/language-service`  | Core language intelligence and compiler-adapter logic      |
| `packages/language-server`   | LSP server on top of language-service                      |
| `packages/vscode-extension`  | VS Code extension client + grammar + commands              |
| `packages/typescript-plugin` | TS server plugin for QingKuai-specific behavior            |
| `packages/mcp-server`        | Model Context Protocol server for AI assistant integration |

## Install Vscode Extension

Install from VS Code Marketplace:

- `qingkuai-tools.qingkuai-language-features`
- https://marketplace.visualstudio.com/items?itemName=qingkuai-tools.qingkuai-language-features

After installation, open any `.qk` file to activate the extension.

### Features

- **Rich Syntax Highlighting** — Full support for `.qk` files and embedded languages (`js/ts/css/sass/scss/less/stylus/postcss`)
- **Smart Completions** — Context-aware suggestions for directives, attributes, slots, and events
- **Hover Documentation** — Instant inline help with type information for directives and framework keywords
- **Type Checking & Diagnostics** — Real-time analysis powered by compiler integration, including generic type validation
- **Code Navigation** — Go to Definition / References / Rename / Code Lens / Signature Help support
- **Document Formatting** — Prettier-based formatting with Qingkuai-specific rules and support for component tags with generic parameters
- **AI Integration** — Optional Model Context Protocol (MCP) server support for AI assistant tools

## Local Development

### Requirements

- Node.js 18+
- pnpm 8+

### Setup

```bash
git clone https://github.com/qingkuai-js/language-features.git
cd language-features
pnpm install
```

### Build

```bash
npm run build
```

This command builds all packages via Rollup and emits outputs into `dist` directories.

### Watch Mode

```bash
npm run dev
```

### Grammar Build (extension package)

```bash
cd packages/vscode-extension
npm run build:grammars
```

## Architecture Overview

1. VS Code extension starts and launches the QingKuai language server.
2. Extension configures the TypeScript plugin (`typescript-plugin-qingkuai`) for tsserver.
3. Language server delegates core analysis/format/diagnostics to `qingkuai-language-service`.
4. Language service integrates compiler output and framework-specific semantics.
5. Optional: MCP server provides QingKuai tools and analysis to compatible AI assistants (Claude, etc.)

## License

MIT