Qingkuai Mcp Server

io.github.qingkuai-jsPublished by GitHub account qingkuai-jsv1.0.13Updated Nov 3, 2026

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

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Local MCP server for the Qingkuai (.qk) framework: searches official docs, checks syntax, compiles to JavaScript, and formats .qk files.

What you can do
  • Search and read the official Qingkuai reference docs by query or docs URI, including single sections
  • Check .qk source syntax and get errors, warnings and type information
  • Compile .qk source to JavaScript with source maps
  • Format .qk files with Prettier and the Qingkuai plugin
  • Return authoritative install and scaffold guidance for starting a new Qingkuai project
When to use it
Useful when an assistant writes, reviews or debugs Qingkuai .qk components and should ground answers in the official docs rather than recalled syntax, and when you want generated or edited .qk code validated and formatted before it is handed back.
Requirements
Runs as a local stdio process, installed from the npm package qingkuai-mcp-server; Node.js is required (the workspace lists Node.js 18+). No authentication, environment variables or headers are declared. Desktop only; not executable in a web client.
Before you install
The server's instructions tell assistants to consult its docs tools before writing .qk syntax and to verify code with the syntax check; treat that as guidance, not a guarantee. Formatting and compilation act on the file content you pass in, so review changes before applying them. For type checking it points to the separately installed @qingkuai/cli.

Installation

In SourceWeft

  1. Open Qingkuai Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit d8fd75e

Tools

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.

ParametersfilePathrequired

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.

ParameterssourcerequiredallowConstReactive

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.

ParametersdebughashIdsourcerequiredsourcemapwhitespacereactivityModeallowConstReactiveinterpretiveCommentspreserveHtmlCommentsrequireReactivityMark

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.

Parameterslimitquery

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.

Parameterslimitqueryrequired

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.

Parametersurirequired

Version history

2
  1. v1.0.13LatestNov 1, 2026
  2. v1.0.2Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts