io.github.qingkuai-js/qingkuai-mcp-server
MCP server for Qingkuai (.qk) — docs search, syntax check, compilation, and formatting tools.
Open source Open in the app JSON README (API)
About
MCP server for Qingkuai (.qk) — docs search, syntax check, compilation, and formatting tools.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- qingkuai-js
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Stars
- 3
- Last push
- 2026-08-15T01:27:43Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:15
- Updated
- 2026-08-29 04:01:15
- Origin id
io.github.qingkuai-js/qingkuai-mcp-server
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