qingkuai-mcp-server

Qingkuai 语言功能

Qingkuai Language Features 是 QingKuai 文件（.qk）的官方语言工具工作区。

其中包含 VS Code 扩展使用的完整工具链，包括：

• 语言语法和语法高亮
• 语言服务（分析、补全、格式化、诊断）
• 语言服务端（LSP）
• TypeScript 插件集成

工作区包

包	描述
packages/language-service	核心语言智能功能和编译器适配逻辑
packages/language-server	基于 language-service 的 LSP 服务端
packages/vscode-extension	VS Code 扩展客户端 + 语法 + 命令
packages/typescript-plugin	为 QingKuai 特定行为提供支持的 TS 服务端插件
packages/mcp-server	用于集成 AI 助手的 Model Context Protocol 服务

安装 Vscode 扩展

从 VS Code Marketplace 安装：

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

安装后，打开任意 .qk 文件即可激活扩展。

功能

• 丰富的语法高亮 — 全面支持 .qk 文件和嵌入式语言（js/ts/css/sass/scss/less/stylus/postcss）
• 智能补全 — 针对指令、属性、插槽和事件提供上下文相关的建议
• 悬停文档 — 即时显示指令和框架关键字的内联帮助及类型信息
• 类型检查与诊断 — 通过编译器集成提供实时分析，包括泛型类型验证
• 代码导航 — 支持转到定义、引用、重命名、代码透镜和签名帮助
• 文档格式化 — 基于 Prettier 的格式化，采用 Qingkuai 特定规则，并支持带泛型参数的组件标签
• AI 集成 — 可选支持 Model Context Protocol（MCP）服务，为 AI 助手提供工具

本地开发

要求

• Node.js 18+
• pnpm 8+

设置

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

构建

npm run build

此命令通过 Rollup 构建所有包，并将输出写入 dist 目录。

监视模式

npm run dev

语法构建（扩展包）

cd packages/vscode-extension
npm run build:grammars

打包载荷检查（扩展包）

发布前，请在运行 npm run build 后执行此命令：

cd packages/vscode-extension
npm run verify:packed

此命令会暂存 VS Code 将随扩展发布的文件（依据 .vscodeignore 和生产依赖），然后从该布局启动语言服务端和 MCP 服务，并注入宿主 TypeScript，且磁盘上不包含 typescript 包。传入 --keep 可保留暂存目录以供检查。请先停止监视模式（npm run dev）：它会用开发构建重写 dist，使依赖保持外置，而检查会（正确地）拒绝这种情况。

架构概述

1. VS Code 扩展启动并运行 QingKuai 语言服务端。
2. 扩展为 tsserver 配置 TypeScript 插件（typescript-plugin-qingkuai）。
3. 语言服务端将核心分析、格式化和诊断工作委托给 qingkuai-language-service。
4. 语言服务整合编译器输出和框架特定语义。
5. 可选：MCP 服务为兼容的 AI 助手（如 Claude）提供 QingKuai 工具和分析功能。

许可证

MIT