qwen3 MCP

注意：这仍在开发中，是一个预览版。 目前正在Qwen3 Coder Next REAP 40B A3B上进行测试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服务器

一个完整的MCP服务器，为LM Studio的Qwen3（或任何本地LLM）提供完整的编码代理功能，包括80多种用于文件操作、命令执行、git、网络搜索、内存、规划和完整技能系统的工具。

特性

• 两种服务器模式:

- HTTP模式 -基于浏览器的聊天http://localhost:3847/chat.html - MCP模式 -与LM Studio的MCP接口直接集成

• 80+工具 包括：

- 文件操作（读、写、编辑、搜索、glob） - 命令执行（shell、后台进程） - Git操作（状态、差异、提交、分支、推送、拉取） - Web工具（搜索、图像搜索、URL获取） - 记忆和计划（笔记、草稿、任务列表、计划） - 媒体（阅读图片、PDF、截图） - Jupyter笔记本支持 - ComfyUI集成（32个工作流工具） - GitHub博客（Jekyll博客创建、主题、部署）

• 工具名称别名 -服务器端路由处理常见的模型幻觉（例如。， edit -> edit_file, bash -> execute_command)

• 技能体系 -16个预装技能+从安装更多 出色的代理技能

快速开始

HTTP模式（浏览器聊天）

# Start the server
start-chat.bat

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

MCP模式（LM Studio Direct）

添加到LM Studio MCP配置(~/.lmstudio/mcp-servers.json):

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

替换 `` 使用您安装服务器的实际路径。

然后重新启动LM Studio。

安装

先决条件

• Node.js 18+
• LM Studio已加载模型（建议使用Qwen3）

快速设置（Windows）

cd 
setup.bat

这将：

1. 安装npm依赖项
2. 创建所需目录
3. 自动配置LM Studio MCP

手动设置

# Install dependencies
npm install

# Setup MCP config for LM Studio
npm run setup

npm脚本

项目结构

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
│       ├── github-blog.js # Jekyll blog tools
│       └── skills.js      # Skills system
├── frontend/
│   ├── server.js          # HTTP server (port 3847)
│   ├── chat.html          # Browser chat interface
│   └── index.html         # Image viewer interface
├── skills/                # Installed skills (16)
│   ├── chrome-extension/  # Chrome extension development (MV3)
│   ├── code-review/       # Code review methodology
│   ├── comfyui-nodes/     # ComfyUI custom node development
│   ├── comfyui-workflow/  # ComfyUI workflow creation
│   ├── differential-review/ # Security-focused diff review
│   ├── docx/              # Word document creation
│   ├── frontend-design/   # Frontend UI/UX
│   ├── github-blog/       # Jekyll blog for GitHub Pages
│   ├── mcp-builder/       # Build MCP servers
│   ├── modern-python/     # Python tooling (uv, ruff)
│   ├── react-best-practices/ # React patterns (Vercel)
│   ├── shadcn-ui/         # Modern component library
│   ├── static-analysis/   # CodeQL, Semgrep, SARIF
│   ├── testing-handbook-skills/ # Fuzzers, sanitizers
│   ├── web-artifacts-builder/ # HTML/React prototypes
│   └── web-design-guidelines/ # UI/UX fundamentals
├── start-chat.bat         # Start HTTP server
├── stop-chat.bat          # Stop server
├── restart-chat.bat       # Restart server
└── install-skill.bat      # Install skills from GitHub

可用工具（80+）

文件操作

编辑工具

搜索

命令执行

Git

网络

记忆与规划

GitHub博客

技能

公用事业

技能体系

技能是教授人工智能专业任务的指令包。模型会根据您的请求自动检测要加载的技能。

安装技能（16）

代码质量和安全：

• 代码审查 -代码审查方法
• 差别审查 -以安全为重点的差异评审
• 静态分析 -CodeQL、Semgrep、SARIF
• 测试手册技能 -引信、消毒剂、覆盖物

Web开发：

• 反应最佳实践 -反应模式（Vercel）
• 网页设计指南 -UI/UX基础
• shadcn ui -现代组件库
• 前端设计 -前端UI/UX
• web工件生成器 -HTML/RReact原型

ComfyUI和创意：

• comfyui节点 -自定义节点开发（V1+V3 API）
• comfyui工作流程 -工作流创建（SD1.5/SDXL/SD3.5/Flux）

开发工具：

• 镀铬延伸 -Chrome扩展程序开发（MV3）
• mcp构建器 -构建MCP服务器
• 现代python -Python工具（uv、ruff、pytest）
• docx 文件 -Word文档创建
• github博客 -GitHub页面的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工作室设置（MCP模式）

1. 添加MCP配置（见上文快速入门）
2. 重新启动LM Studio
3. 工具会自动出现在模型上下文中

API端点（HTTP模式）

测试

# 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

故障排除

服务器问题

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

# Restart
restart-chat.bat

# Force stop
stop-chat.bat

MCP连接问题

1. 检查LM Studio控制台是否有错误
2. 验证mcp-servers.json中的路径是否正确
3. 跑 node src/index.js 手动测试

read_file超时/WebSocket错误

这 read_file 该工具默认为500行，以防止LM Studio WebSocket超时。 对于大文件，使用分页：

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

工具名称错误

如果模型调用了错误的工具名称（例如。， edit 而不是 edit_file)，服务器具有内置别名，用于路由常见错误。如果仍然看到错误，请更新LM Studio中的系统提示——请参阅 SYSTEM_PROMPT.md 以获得正确的提示。

工具错误

1. 检查浏览器控制台（F12）的HTTP模式
2. 验证工作目录权限
3. 检查LM Studio模型是否支持函数调用

许可证

麻省理工学院