Note: This is still under development and is a preview. Currently testing on Qwen3 Coder Next REAP 40B A3B from here https://huggingface.co/lovedheart/Qwen3-Coder-Next-REAP-40B-A3B-GGUF/resolve/main/Qwen3-Coder-Next-REAP-40B-A3B-Q4_K_XL.gguf

Qwen3 MCP Server

A complete MCP server that gives LM Studio's Qwen3 (or any local LLM) full coding agent capabilities including 80+ tools for file operations, command execution, git, web search, memory, planning, and a full skills system.

Features

Two Server Modes:
- HTTP Mode - Browser-based chat at http://localhost:3847/chat.html
- MCP Mode - Direct integration with LM Studio's MCP interface
80+ Tools including:
- File operations (read, write, edit, search, glob)
- Command execution (bash, background processes)
- Git operations (status, diff, commit, branch, push, pull)
- Web tools (search, image search, Wikipedia, URL fetch)
- Memory & planning (notes, scratchpads, task lists, plans)
- Media (read images, PDFs, screenshots)
- Jupyter notebook support
- ComfyUI integration (32 workflow tools)
Skills System - Install and use skills from awesome-agent-skills

Quick Start

HTTP Mode (Browser Chat)

# Start the server
start-chat.bat

# Open in browser
http://localhost:3847/chat.html

MCP Mode (LM Studio Direct)

Add to your LM Studio MCP config (~/.lmstudio/mcp-servers.json):

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

Replace <YOUR_PATH> with the actual path where you installed the server.

Then restart LM Studio.

Installation

Prerequisites

Node.js 18+
LM Studio with a model loaded (Qwen3 recommended)

Quick Setup (Windows)

cd <YOUR_PATH>
setup.bat

This will:

Install npm dependencies
Create required directories
Configure LM Studio MCP automatically

Manual Setup

# Install dependencies
npm install

# Setup MCP config for LM Studio
npm run setup

npm Scripts

| Command | Description | |---------|-------------| | npm run setup | Configure LM Studio MCP | | npm run start | Start HTTP server (port 3847) | | npm run mcp | Run MCP server directly (stdio) | | npm run dev | Start with auto-reload |

Project Structure

qwen3-mcp/
├── src/
│   ├── index.js           # MCP server (stdio mode)
│   └── tools/             # Tool implementations
│       ├── filesystem.js  # File operations
│       ├── edit.js        # File editing
│       ├── bash.js        # Command execution
│       ├── git.js         # Git operations
│       ├── search.js      # Glob/grep search
│       ├── web.js         # Web search, fetch
│       ├── memory.js      # Notes, scratchpads
│       ├── planning.js    # Plans, task tracking
│       ├── tasks.js       # Todo lists
│       ├── thinking.js    # Reasoning tools
│       ├── context.js     # Conversation context
│       ├── interaction.js # User prompts
│       ├── media.js       # Images, PDFs
│       ├── notebook.js    # Jupyter support
│       ├── comfyui.js     # ComfyUI workflows
│       └── skills.js      # Skills system
├── frontend/
│   ├── server.js          # HTTP server (port 3847)
│   └── chat.html          # Browser chat interface
├── skills/                # Installed skills
│   ├── code-review/
│   ├── comfyui-nodes/     # ComfyUI node development
│   ├── comfyui-workflow/
│   ├── docx/
│   └── modern-python/
├── start-chat.bat         # Start HTTP server
├── stop-chat.bat          # Stop server
├── restart-chat.bat       # Restart server
└── install-skill.bat      # Install skills from GitHub

Available Tools (80+)

File Operations

| Tool | Description | |------|-------------| | read_file | Read file contents with line numbers (default 500 line limit) | | write_file | Write/create files | | edit_file | Find and replace in files | | list_directory | List directory contents | | create_directory | Create directories | | delete_file | Delete files | | move_file | Move/rename files | | copy_file | Copy files | | file_info | Get file metadata |

Search

| Tool | Description | |------|-------------| | glob_search | Find files by pattern (**/*.js) | | grep_search | Search file contents with regex | | find_definition | Find code definitions |

Command Execution

| Tool | Description | |------|-------------| | execute_command | Run shell commands | | execute_background | Run commands in background | | read_output | Read background process output | | kill_session | Kill background process | | list_sessions | List running processes |

Git

| Tool | Description | |------|-------------| | git_status | Repository status | | git_diff | Show changes | | git_log | Commit history | | git_add | Stage files | | git_commit | Create commits | | git_branch | List/create branches | | git_checkout | Switch branches | | git_push | Push to remote | | git_pull | Pull from remote | | git_clone | Clone repositories |

Web

| Tool | Description | |------|-------------| | web_search | DuckDuckGo search (SafeSearch off) | | web_image_search | Bing image search with download | | web_fetch | Fetch webpage content | | wikipedia | Wikipedia lookup |

Memory & Planning

| Tool | Description | |------|-------------| | memory_store | Store notes | | memory_recall | Search notes | | memory_list | List all notes | | scratchpad_write | Write to scratchpad | | scratchpad_read | Read scratchpad | | plan_create | Create execution plans | | plan_status | Check plan progress | | task_add | Add todo items | | task_list | List todos |

Skills

| Tool | Description | |------|-------------| | list_skills | List installed skills | | load_skill | Load skill instructions | | install_skill | Install from GitHub |

Utilities

| Tool | Description | |------|-------------| | get_current_time | Current date/time | | calculator | Math expressions | | think | Record thinking notes | | ask_user | Prompt user for input |

Skills System

Skills are instruction packages that teach the AI specialized tasks.

Installed Skills (14)

Code Quality & Security:

code-review - Code review methodology
differential-review - Security-focused diff review
static-analysis - CodeQL, Semgrep, SARIF
testing-handbook-skills - Fuzzers, sanitizers, coverage

Web Development:

react-best-practices - React patterns (Vercel)
web-design-guidelines - UI/UX fundamentals
shadcn-ui - Modern component library
frontend-design - Frontend UI/UX
web-artifacts-builder - HTML/React prototypes

ComfyUI & Tools:

comfyui-nodes - Custom node development
comfyui-workflow - Workflow creation
mcp-builder - Build MCP servers
modern-python - Python tooling (uv, ruff, pytest)
docx - Word document creation

Install More Skills

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

Using Skills

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

Configuration

HTTP Server Port

Edit frontend/server.js:

const PORT = 3847;

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | IMAGE_DOWNLOAD_DIR | ~/lmstudio-images | Image download location |

LM Studio Setup (HTTP Mode)

Load a model (Qwen3 recommended)
Enable API server (default: localhost:1234)
Open http://localhost:3847/chat.html
Enter API token if authentication is enabled

LM Studio Setup (MCP Mode)

Add MCP config (see Quick Start above)
Restart LM Studio
Tools appear automatically in model context

API Endpoints (HTTP Mode)

| Endpoint | Method | Description | |----------|--------|-------------| | / | GET | Image viewer UI | | /chat.html | GET | Chat interface | | /tool | POST | Execute tool {name, args} | | /skills | GET | List skills (JSON) | | /skill?name=X | GET | Get skill details |

Testing

# Test a tool
curl -X POST http://localhost:3847/tool \
  -H "Content-Type: application/json" \
  -d '{"name":"get_current_time","args":{}}'

# List skills
curl http://localhost:3847/skills

Troubleshooting

Server Issues

# Check if running
curl http://localhost:3847/skills

# Restart
restart-chat.bat

# Force stop
stop-chat.bat

MCP Connection Issues

Check LM Studio console for errors
Verify path in mcp-servers.json is correct
Run node src/index.js manually to test

read_file Timeouts / WebSocket Errors

The read_file tool now defaults to 500 lines to prevent LM Studio WebSocket timeouts. For large files, use pagination:

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

Tool Errors

Check browser console (F12) for HTTP mode
Verify working directory permissions
Check LM Studio model supports function calling

License

MIT

MCP Servers