Qingkuai Mcp Server

io.github.qingkuai-js由 GitHub 账号 qingkuai-js 发布v1.0.13更新于 Nov 3, 2026

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

已验证STDIO仅桌面知识与记忆开发者工具

概览

AI 生成的概览

面向 Qingkuai（.qk）框架的本地 MCP 服务器：检索官方文档、检查语法、编译为 JavaScript，并格式化 .qk 文件。

可以做什么
  • 按查询词或文档 URI 搜索并阅读 Qingkuai 官方参考文档，可只读某一节
  • 检查 .qk 源码语法，返回错误、警告与类型信息
  • 将 .qk 源码编译为 JavaScript 并生成 source map
  • 使用 Prettier 与 Qingkuai 插件格式化 .qk 文件
  • 返回新建 Qingkuai 项目的权威安装与脚手架说明
适用场景
适合在助手编写、审查或调试 Qingkuai .qk 组件时使用，让回答基于官方文档而非凭记忆写语法；也适合在交付前对生成或修改过的 .qk 代码做校验与格式化。
运行要求
以本地 stdio 进程运行，通过 npm 包 qingkuai-mcp-server 安装，需要 Node.js（工作区标注 Node.js 18+）。未声明认证、环境变量或请求头。仅限桌面端，无法在网页客户端中执行。
安装前请注意
服务器指令要求助手在编写 .qk 语法前先调用其文档工具，并用语法检查验证代码，这属于建议而非保证。格式化与编译会处理你传入的文件内容，应用前请先审阅改动。类型检查需另行安装 @qingkuai/cli。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Qingkuai Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

PackageDescription
packages/language-serviceCore language intelligence and compiler-adapter logic
packages/language-serverLSP server on top of language-service
packages/vscode-extensionVS Code extension client + grammar + commands
packages/typescript-pluginTS server plugin for QingKuai-specific behavior
packages/mcp-serverModel Context Protocol server for AI assistant integration

Install Vscode Extension

Install from VS Code Marketplace:

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.gitcd language-featurespnpm 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-extensionnpm run build:grammars

Packed Payload Check (extension package)

Before publishing, run this after npm run build:

bash
cd packages/vscode-extensionnpm run verify:packed

It stages the files VS Code would ship (per .vscodeignore and the production dependencies), then boots the language server and the MCP server from that layout with the host typescript injected and no typescript package on disk. Pass --keep to keep the staged directory for inspection. Stop watch mode (npm run dev) first: it rewrites dist with a development build that keeps dependencies external, which the check will (correctly) reject.

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

来源：README.md，提交 d8fd75e

工具

6

format_qingkuai_code

Format Qingkuai Code

Format a Qingkuai (.qk) file using Prettier with the Qingkuai plugin. Applies consistent code style and formatting: - Indentation and spacing normalization - Line breaking and wrapping - Consistent quote styles (template literals, single quotes, etc.) - Component attribute formatting Input is a file path. The tool reads file contents, loads Prettier config with that path, formats, and writes back to the same file. Returns write result and any formatting errors. Use this when the user wants to format, reformat, or fix the styling of a .qk file.

输入参数filePath必填

check_qingkuai_syntax

Check Qingkuai Syntax

Check Qingkuai (.qk) source code syntax without full compilation. Performs early stage compilation (template parsing, script analysis) to validate: - Template structure and tag nesting - Script syntax errors - Directive usage and attributes Returns syntax errors, warnings, and type information without code generation. Use this when the user wants to validate or check .qk code syntax, or reports a syntax error in a .qk file.

输入参数source必填allowConstReactive

compile_qingkuai

Compile Qingkuai Code

Compile Qingkuai (.qk) source code to JavaScript. Performs full compilation pipeline: - Syntax validation (parsing, analysis) - Template compilation to render functions - Reactivity detection and optimization - Source map generation Returns compiled JavaScript code, error messages, and source mappings. Use this when the user wants to compile or transpile .qk source code to JavaScript, or asks about the compilation result.

输入参数debughashIdsource必填sourcemapwhitespacereactivityModeallowConstReactiveinterpretiveCommentspreserveHtmlCommentsrequireReactivityMark

get_qingkuai_project_bootstrap_guide

Get Qingkuai Project Bootstrap Guide

Use this first when user asks to create/init a Qingkuai project in a new or empty folder. Returns authoritative install/scaffold docs URIs and snippets.

输入参数limitquery

search_qingkuai_docs

Search Qingkuai Syntax Docs

Search the official Qingkuai reference docs for .qk files. This is the AUTHORITATIVE source for Qingkuai syntax, directives, attributes, events, reactivity, and components. Accepts English, Chinese, or syntax tokens (e.g. #for, &value, qk:spread). ALWAYS call this tool when the user asks about Qingkuai syntax, grammar, directives, attributes, events, interpolation, reactivity, components, compiler rules, or how to write .qk code — do NOT answer from memory. Results include matched doc sections with full content inline. Base answers on these sections; call read_qingkuai_doc for a full document or a specific section. Verify generated .qk code with check_qingkuai_syntax afterwards.

输入参数limitquery必填

read_qingkuai_doc

Read Qingkuai Doc

Read a Qingkuai doc by its docs:// URI (as returned by search_qingkuai_docs). Supports an #section anchor to read a single section; without an anchor the full document is returned. Unknown URIs return the closest valid URIs.

输入参数uri必填

版本历史

2
  1. v1.0.13最新Nov 1, 2026
  2. v1.0.2Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分