mcpField
Q
qingkuai-mcp-server

qingkuai-mcp-server

ローカル
github.com/qingkuai-js開発ツール31 日前に更新
リポジトリ

qingkuai-mcp-server について

qingkuai-mcp-serverは、QingKuai言語ツールワークスペースに含まれるMCPコンポーネントで、`.qk`ファイルを扱うAIアシスタント向けです。言語サービス、LSPサーバー、VS Code拡張機能とともに、QingKuaiのツールと分析機能を提供します。

主な機能

  1. 01QingKuaiの言語分析
  2. 02AIアシスタント向けMCPツール
  3. 03言語サービスと診断
  4. 04LSPサーバー
  5. 05VS Code拡張機能と構文ハイライト

活用シーン

  1. 01AIによる`.qk`ファイルの作業支援
  2. 02QingKuaiコードの分析
  3. 03VS CodeでQingKuai言語ツールを利用

MCP 対応

互換性のあるAIアシスタントに、QingKuaiのツールと分析機能を提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "qingkuai-js-qingkuai": {
      "command": "npx",
      "args": [
        "-y",
        "qingkuai-mcp-server"
      ]
    }
  }
}
起動コマンドnpx -y qingkuai-mcp-server

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmqingkuai-mcp-server1.0.2

ツール

4

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
filePathstringはいフォーマットして書き戻す .qk ファイルの絶対パスまたはワークスペース相対パス

詳細

Qingkuai の言語機能

Qingkuai Language Features は、QingKuai ファイル（.qk）用の公式言語ツールワークスペースです。

VS Code 拡張機能で使用するツールチェーン一式が含まれています。具体的には、次のとおりです。

  • 言語文法とシンタックスハイライト
  • 言語サービス（解析、補完、フォーマット、診断）
  • 言語サーバー（LSP）
  • TypeScript プラグインとの統合

ワークスペースのパッケージ

パッケージ説明
packages/language-service言語インテリジェンスの中核とコンパイラーアダプターのロジック
packages/language-serverlanguage-service 上に構築された LSP サーバー
packages/vscode-extensionVS Code 拡張機能のクライアント＋文法＋コマンド
packages/typescript-pluginQingKuai 固有の動作を実現する TS サーバープラグイン
packages/mcp-serverAI アシスタントとの統合用 Model Context Protocol サーバー

VS Code 拡張機能のインストール

VS Code Marketplace からインストールします。

インストール後、任意の .qk ファイルを開くと拡張機能が有効になります。

機能
  • 豊富なシンタックスハイライト — .qk ファイルと埋め込み言語（js/ts/css/sass/scss/less/stylus/postcss）を完全にサポートします
  • スマート補完 — ディレクティブ、属性、スロット、イベントをコンテキストに応じて提案します
  • ホバードキュメント — ディレクティブやフレームワークのキーワードについて、型情報を含むインラインヘルプをすぐに表示します
  • 型チェックと診断 — ジェネリック型の検証を含む、コンパイラー統合によるリアルタイム解析を提供します
  • コードナビゲーション — 定義へ移動／参照／名前の変更／コードレンズ／シグネチャヘルプをサポートします
  • ドキュメントのフォーマット — Prettier ベースのフォーマットに Qingkuai 固有のルールを適用し、ジェネリックパラメーターを持つコンポーネントタグをサポートします
  • AI 連携 — AI アシスタントツール向けの Model Context Protocol（MCP）サーバーをオプションでサポートします

ローカル開発

要件
  • 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

.vscodeignore と本番用依存関係に基づいて、VS Code が同梱するファイルをステージングします。その後、そのレイアウトから、ホストの TypeScript を注入し、ディスク上に typescript パッケージがない状態で、言語サーバーと MCP サーバーを起動します。ステージングしたディレクトリを確認用に残すには、--keep を指定してください。先にウォッチモード（npm run dev）を停止してください。ウォッチモードは開発用ビルドで dist を書き換え、依存関係を外部のままにするため、このチェックでは（正しく）拒否されます。

アーキテクチャの概要

  1. VS Code 拡張機能が起動し、QingKuai 言語サーバーを立ち上げます。
  2. 拡張機能が tsserver 用の TypeScript プラグイン（typescript-plugin-qingkuai）を設定します。
  3. 言語サーバーが中核となる解析／フォーマット／診断を qingkuai-language-service に委譲します。
  4. 言語サービスがコンパイラーの出力とフレームワーク固有のセマンティクスを統合します。
  5. オプション：MCP サーバーが QingKuai のツールと解析を、対応する AI アシスタント（Claude など）に提供します。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。