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 分