WorkBuddy + LM Studio 本地模型批量配置指南
📋 概述
本文档说明如何将 LM Studio 中的本地模型批量导入到 WorkBuddy，使其能够使用 MCP（Model Context Protocol）工具调用这些模型。
LM Studio API Token 获取与权限配置完全指南
最新版 Claude Desktop + LM Studio 直连配置指南（LM Studio 0.4.19+）
🔍 问题背景
WorkBuddy 的积分用完了想继续当前的工作，但模型列表只有几个手动配置的模型，没有 LM Studio 其他模型的选项，一项项配置非常耗时。于是可以发指令给 WorkBuddy 让它自己给自己配置，并且完善候选模型列表，本文记录了批量配置时容易遇到的问题和解决方案。
WorkBuddy 有两个相关但独立的数据存储位置：
- MCP 配置(
~/.workbuddy/mcp.json) - 用于定义外部 MCP 服务器连接 - 本地模型列表(
~/.workbuddy/models.json) - WorkBuddy UI 中显示和选择模型的来源
🛠️ 完整配置步骤
第一步：从 LM Studio 获取模型 ID
LM Studio 在localhost:1234上提供 API 端点。使用以下命令获取所有已加载模型的列表：
curl -s http://localhost:1234/v1/models | jq '.data[] | {id, name}'示例输出：
{ "id": "qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored", "name": "Qwen3.5 - Claude (HighIQ)" }第二步：编辑 MCP 服务器配置
打开~/.workbuddy/mcp.json，添加新的 LM Studio MCP 服务器条目（放在最底部）：
{ "mcpServers": { // ... 其他现有配置 ... "lmstudio-models": { "type": "model", "models": [ {"id": "qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored"}, {"id": "glm-4.7-flash-uncensored-heretic-neo-code-imatrix-max"}, // ... 更多模型 ... ], "base_url": "http://localhost:1234/v1", "default_model": "qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored" } } }第三步：编辑 WorkBuddy 本地模型列表
这是关键步骤！打开~/.workbuddy/models.json，用 LM Studio 模型替换所有现有条目。每个模型需要以下配置项：
| 字段 | 说明 | 示例值 |
|---|---|---|
id | 唯一标识符（必须与 MCP ID 匹配） | qwen3.5-9b-claude... |
name | 用户友好的名称 | Qwen3.5 - Claude (HighIQ) |
vendor | 模型来源 | LM Studio |
url | API 端点 | http://localhost:1234/v1 |
apiKey | API 密钥 | sk-lm-XXXX:YYYY |
第四步：验证配置
重启 WorkBuddy 后，在 UI 中检查：
- ✅ "已保存模型"列表中应显示所有 LM Studio 模型
- ✅ 默认选中的应该是第一个 Qwen3.5 模型
- ✅ MCP 连接状态应为"活跃"
📦 完整的模型列表模板
[ { "id": "qwen3.5-9b-claude-4.6-highiq-instruct-heretic-uncensored", "name": "Qwen3.5 - Claude (HighIQ)", "vendor": "LM Studio", "url": "http://localhost:1234/v1", "apiKey": "sk-lm-M05udwxr:Xut1wBZYgLdD1deXCRW8", "supportsToolCall": true, "supportsImages": true, "supportsReasoning": true, "useCustomProtocol": false, "defaultModel": true }, { "id": "glm-4.7-flash-uncensored-heretic-neo-code-imatrix-max", "name": "GLM-4.7 Flash (Uncensored)", "vendor": "LM Studio", "url": "http://localhost:1234/v1", "apiKey": "sk-lm-M05udwxr:Xut1wBZYgLdD1deXCRW8", "supportsToolCall": true, "supportsImages": false, "supportsReasoning": false, "useCustomProtocol": false }, // ... 更多模型 ... ]🔧 故障排查
Q1: MCP 服务器没有出现在列表中？
- 确认 MCP 服务器在
mcp.json中正确配置 - 检查 LM Studio 是否在运行（端口 1234）
- 重启 WorkBuddy
Q2: 模型列表未更新？
- MCP 配置不是实时同步的
- 必须手动编辑
models.json文件 - 确保每个模型的
id与 MCP 配置中的 ID 完全匹配
Q3: API 密钥无效？
- 默认格式：
sk-lm-XXXX:YYYY - 可以自定义，但前缀应为
sk-lm-
📊 关键配置对比
| 配置文件 | 用途 | 自动同步 | 需要重启 |
|---|---|---|---|
mcp.json | MCP 服务器定义 | ✅ | ❌ |
models.json | UI 模型来源列表 | ❌ | ❌ |
🎯 最佳实践
- 版本控制：将
mcp.json和models.json纳入 Git 版本管理 - 定期备份：保存这些配置文件以防意外删除
- 命名约定：为模型使用清晰、描述性的名称
- API Key 安全：不要将这些密钥提交到公共仓库
📝 修改历史
| 日期 | 作者 | 变更说明 |
|---|---|---|
| 2026-07-22 | WorkBuddy Assistant | 初始创建，添加 LM Studio 配置支持 |
文档版本: 1.0
最后更新: 2026-07-22 20:53
