Qwen3 MCP

🚀 Qwen3 MCP サーバー

Qwen3 MCPサーバーは、LM StudioのQwen3（または任意のローカルLLM）に完全なコーディングエージェント機能を付与する完全なMCPサーバーです。ファイル操作、コマンド実行、git、ウェブ検索、メモリ、計画立案、および完全なスキルシステムなど、80以上のツールが用意されています。

🚀 クイックスタート

HTTPモード（ブラウザチャット）

# サーバーを起動する
start-chat.bat

# ブラウザで開く
http://localhost:3847/chat.html

MCPモード（LM Studio直接接続）

LM StudioのMCP設定ファイル（~/.lmstudio/mcp-servers.json）に以下を追加します。

{
  "mcpServers": {
    "qwen3-mcp": {
      "command": "node",
      "args": ["<YOUR_PATH>/src/index.js"],
      "cwd": "<YOUR_PATH>"
    }
  }
}

<YOUR_PATH> をサーバーをインストールした実際のパスに置き換えてください。 その後、LM Studioを再起動します。

✨ 主な機能

• 2つのサーバーモード
  • HTTPモード - http://localhost:3847/chat.html でブラウザベースのチャットが可能です。
  • MCPモード - LM StudioのMCPインターフェイスと直接統合できます。
• 80以上のツール
  • ファイル操作（読み取り、書き込み、編集、検索、グロブ）
  • コマンド実行（シェル、バックグラウンドプロセス）
  • Git操作（ステータス、差分、コミット、ブランチ、プッシュ、プル）
  • ウェブツール（検索、画像検索、URL取得）
  • メモリと計画立案（ノート、スクラッチパッド、タスクリスト、計画）
  • メディア（画像、PDF、スクリーンショットの読み取り）
  • Jupyterノートブックサポート
  • ComfyUI統合（32のワークフローツール）
  • GitHubブログ（Jekyllブログの作成、テーマ、デプロイ）
• ツール名のエイリアス - サーバー側のルーティングが一般的なモデルのハリュシネーションを処理します（例: edit -> edit_file, bash -> execute_command）
• スキルシステム - 16の事前インストール済みスキル + awesome-agent-skills からさらにスキルをインストールできます。

📦 インストール

前提条件

• Node.js 18以上
• モデルがロードされたLM Studio（Qwen3を推奨）

クイックセットアップ（Windows）

cd <YOUR_PATH>
setup.bat

これにより以下のことが行われます。

1. npm依存関係のインストール
2. 必要なディレクトリの作成
3. LM Studio MCPの自動設定

手動セットアップ

# 依存関係のインストール
npm install

# LM StudioのMCP設定をセットアップ
npm run setup

npmスクリプト

💻 使用例

基本的な使用法

HTTPモードでの起動

start-chat.bat

MCPモードでのLM Studio設定

{
  "mcpServers": {
    "qwen3-mcp": {
      "command": "node",
      "args": ["<YOUR_PATH>/src/index.js"],
      "cwd": "<YOUR_PATH>"
    }
  }
}

📚 ドキュメント

プロジェクト構造

qwen3-mcp/
├── src/
│   ├── index.js           # MCPサーバー (標準入出力モード)
│   └── tools/             # ツールの実装
│       ├── filesystem.js  # ファイル操作
│       ├── edit.js        # ファイル編集
│       ├── bash.js        # コマンド実行
│       ├── git.js         # Git操作
│       ├── search.js      # グロブ/グレップ検索
│       ├── web.js         # ウェブ検索、取得
│       ├── memory.js      # ノート、スクラッチパッド
│       ├── planning.js    # 計画、タスク追跡
│       ├── tasks.js       # タスクリスト
│       ├── thinking.js    # 推論ツール
│       ├── context.js     # 会話コンテキスト
│       ├── interaction.js # ユーザープロンプト
│       ├── media.js       # 画像、PDF
│       ├── notebook.js    # Jupyterサポート
│       ├── comfyui.js     # ComfyUIワークフロー
│       ├── github-blog.js # Jekyllブログツール
│       └── skills.js      # スキルシステム
├── frontend/
│   ├── server.js          # HTTPサーバー (ポート3847)
│   ├── chat.html          # ブラウザチャットインターフェイス
│   └── index.html         # 画像ビューアインターフェイス
├── skills/                # インストールされたスキル (16)
│   ├── chrome-extension/  # Chrome拡張機能開発 (MV3)
│   ├── code-review/       # コードレビュー方法論
│   ├── comfyui-nodes/     # ComfyUIカスタムノード開発
│   ├── comfyui-workflow/  # ComfyUIワークフロー作成
│   ├── differential-review/ # セキュリティに焦点を当てた差分レビュー
│   ├── docx/              # Word文書作成
│   ├── frontend-design/   # フロントエンドUI/UX
│   ├── github-blog/       # GitHub Pages用のJekyllブログ
│   ├── mcp-builder/       # MCPサーバーの構築
│   ├── modern-python/     # Pythonツール (uv, ruff)
│   ├── react-best-practices/ # Reactパターン (Vercel)
│   ├── shadcn-ui/         # モダンなコンポーネントライブラリ
│   ├── static-analysis/   # CodeQL, Semgrep, SARIF
│   ├── testing-handbook-skills/ # ファザー、サニタイザー
│   ├── web-artifacts-builder/ # HTML/Reactプロトタイプ
│   └── web-design-guidelines/ # UI/UXの基本原則
├── start-chat.bat         # HTTPサーバーを起動する
├── stop-chat.bat          # サーバーを停止する
├── restart-chat.bat       # サーバーを再起動する
└── install-skill.bat      # GitHubからスキルをインストールする

利用可能なツール（80以上）

ファイル操作

編集ツール

検索

コマンド実行

Git

ウェブ

メモリと計画立案

GitHubブログ

スキル

ユーティリティ

スキルシステム

スキルは、AIに特殊なタスクを教える命令パッケージです。モデルはあなたの要求に基づいて自動的に読み込むスキルを検出します。

インストールされたスキル（16）

コード品質とセキュリティ:

• code-review - コードレビュー方法論
• differential-review - セキュリティに焦点を当てた差分レビュー
• static-analysis - CodeQL, Semgrep, SARIF
• testing-handbook-skills - ファザー、サニタイザー、カバレッジ

ウェブ開発:

• react-best-practices - Reactパターン (Vercel)
• web-design-guidelines - UI/UXの基本原則
• shadcn-ui - モダンなコンポーネントライブラリ
• frontend-design - フロントエンドUI/UX
• web-artifacts-builder - HTML/Reactプロトタイプ

ComfyUIとクリエイティブ:

• comfyui-nodes - カスタムノード開発 (V1 + V3 API)
• comfyui-workflow - ワークフロー作成 (SD1.5/SDXL/SD3.5/Flux)

開発ツール:

• chrome-extension - Chrome拡張機能開発 (MV3)
• mcp-builder - MCPサーバーの構築
• modern-python - Pythonツール (uv, ruff, pytest)
• docx - Word文書作成
• github-blog - GitHub Pages用のJekyllブログ

さらにスキルをインストールする

install-skill.bat https://github.com/anthropics/skills/tree/main/skills/pptx

スキルの使用方法

スキルはあなたの要求に一致すると自動的に読み込まれます。手動で読み込むこともできます。

"What skills do I have?"
"Load the comfyui-nodes skill"
"Use the docx skill to create a report"

設定

HTTPサーバーポート

frontend/server.js を編集します。

const PORT = 3847;

環境変数

LM Studioの設定（HTTPモード）

1. モデルをロードします（Qwen3を推奨）
2. APIサーバーを有効にします（デフォルト: localhost:1234）
3. http://localhost:3847/chat.html を開きます
4. 認証が有効になっている場合はAPIトークンを入力します

LM Studioの設定（MCPモード）

1. MCP設定を追加します（上記のクイックスタートを参照）
2. LM Studioを再起動します
3. ツールが自動的にモデルコンテキストに表示されます

APIエンドポイント（HTTPモード）

テスト

# ツールをテストする
curl -X POST http://localhost:3847/tool \
  -H "Content-Type: application/json" \
  -d '{"name":"get_current_time","args":{}}'

# スキルをリストする
curl http://localhost:3847/skills

トラブルシューティング

サーバーの問題

# 実行中か確認する
curl http://localhost:3847/skills

# 再起動する
restart-chat.bat

# 強制停止する
stop-chat.bat

MCP接続の問題

1. LM Studioのコンソールでエラーを確認します
2. mcp-servers.json内のパスが正しいことを確認します
3. node src/index.js を手動で実行してテストします

read_fileのタイムアウト/WebSocketエラー

read_file ツールは、LM StudioのWebSocketタイムアウトを防ぐためにデフォルトで500行に設定されています。 大きなファイルの場合は、ページネーションを使用します。

read_file with offset=1, limit=100    # 1-100行目
read_file with offset=101, limit=100  # 101-200行目

ツール名のエラー

モデルが間違ったツール名を呼び出した場合（例: edit の代わりに edit_file）、サーバーには一般的な間違いをルーティングする組み込みのエイリアスがあります。エラーが引き続き発生する場合は、LM Studioのシステムプロンプトを更新してください — 正しいプロンプトについては SYSTEM_PROMPT.md を参照してください。

ツールのエラー

1. HTTPモードの場合はブラウザのコンソール（F12）を確認します
2. 作業ディレクトリのパーミッションを確認します
3. LM Studioのモデルが関数呼び出しをサポートしていることを確認します

📄 ライセンス

MIT