LM Studio 中的 MCP

2025-06-25

LM Studio 0.3.17 引入了 模型上下文协议 (MCP) 支持,使您可以将喜欢的 MCP 服务器连接到应用,并将其与本地模型配合使用。

undefined

LM Studio 支持本地和远程 MCP 服务器。您可以通过编辑应用的 mcp.json 文件,或在可用时通过全新的 “添加到 LM Studio”按钮来添加 MCP。

本次发布的新功能还有

  • 得益于我们社区本地化志愿者的贡献,新增支持 11 种语言。LM Studio 现已支持 33 种语言。
  • 包含多项错误修复,以及用户界面改进,包括一款全新的主题:“Solarized Dark”。
通过应用内更新或从 https://lm-studio.cn/download 升级。

将 MCP 服务器添加到 LM Studio

模型上下文协议 (MCP) 是一套用于为 LLM 提供工具和资源访问接口的协议。它最初由 Anthropic 推出,并在 GitHub 上进行开发。

术语

  • “MCP 服务器”:提供工具和资源访问的程序。例如,Stripe、GitHub 或 Notion 都提供了 MCP 服务器
  • “MCP 主机”:可以连接到 MCP 服务器,并将这些服务器的资源提供给模型使用的应用程序(如 LM Studio 或 Claude Desktop)。

安装新服务器:mcp.json

切换到右侧边栏的“程序”(Program) 选项卡。点击 Install > Edit mcp.json

undefined

这将在应用内置编辑器中打开 mcp.json 文件。您可以通过编辑该文件来添加 MCP 服务器。

undefined

使用内置编辑器编辑 mcp.json


LM Studio 目前采用与 Cursor 相同的 mcp.json 规范。

示例 MCP:Hugging Face MCP 服务器

此 MCP 服务器提供对模型和数据集搜索等功能的访问。

{
  "mcpServers": {
    "hf-mcp-server": {
      "url": "https://hugging-face.cn/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_HF_TOKEN>"
      }
    }
  }
}
您需要将 <YOUR_HF_TOKEN> 替换为您实际的 Hugging Face 令牌。点击此处了解更多。

保持谨慎

切勿从不可信的来源安装 MCP。

注意

某些 MCP 服务器可以运行任意代码、访问您的本地文件并使用您的网络连接。安装和使用 MCP 服务器时请务必谨慎。如果您不信任该来源,请勿安装。


工具调用确认

当模型调用工具时,LM Studio 会向用户显示确认对话框。这允许您在执行前审查工具调用参数,并根据需要进行编辑。

undefined

工具调用确认对话框


您可以选择始终允许特定工具,或仅允许一次。

如果您选择始终允许某工具,LM Studio 将不再为该工具显示后续确认对话框。您可以在 App Settings > Tools & Integrations 中对此进行管理。

MCP 支持:更多技术细节

  • 保存 mcp.json 文件时,LM Studio 将自动加载其中定义的 MCP 服务器。我们为每个 MCP 服务器启动一个单独的进程。

  • 对于依赖 npxuvx(或您机器上的任何其他程序)的本地 MCP 服务器,您需要确保这些工具已安装并在系统的 PATH 环境变量中可用。

  • mcp.json 在 macOS 和 Linux 上位于 ~/.lmstudio/mcp.json,在 Windows 上位于 %USERPROFILE%/.lmstudio/mcp.json。建议使用内置编辑器来修改此文件。

如果您遇到错误,请在我们的错误追踪器上提交议题:https://github.com/lmstudio-ai/lmstudio-bug-tracker/issues


开发者:创建“添加到 LM Studio”按钮

我们还引入了一种使用深度链接按钮一键将 MCP 服务器添加到 LM Studio 的方式。

输入您的 MCP JSON 条目,为 Add to LM Studio 按钮生成深度链接。

👇 这是一个真正的交互式工具,您可以用来创建自己的 MCP 安装链接。试一试吧!

未检测到 MCP 服务器

点击按钮复制Markdown到剪贴板。

示例

尝试将以下内容复制并粘贴到上面的链接生成器中。

{
  "hf-mcp-server": {
    "url": "https://hugging-face.cn/mcp",
    "headers": {
      "Authorization": "Bearer <YOUR_HF_TOKEN>"
    }
  }
}
您需要将 <YOUR_HF_TOKEN> 替换为您实际的 Hugging Face 令牌。点击此处了解更多。

还有一件事……

连接 MCP 服务器很容易。那么,为您的模型创建自己的工具和自定义资源又如何呢?

  • 使用此链接注册参加即将到来的私有内测。


0.3.17 - 完整发行说明

版本 10

  • 新增聊天外观设置,可选择仅在最后一条消息、仅在工具提示中,或在所有适用消息上显示消息生成统计信息
  • 令牌计数现在包含系统提示词和工具定义
  • 为内容中包含 URL 的 LLM 消息显示“在浏览器中打开”按钮。
    • 请注意:LLM 可能会生成不可信的 URL。点击链接前请务必验证。

版本 9

  • 默认启用 MCP
  • 在 Mac 上使用 Cmd + Shift + E,或在 PC 上使用 Ctrl + Shift + E,可始终打开当前聊天的系统提示词编辑器

版本 8

Build 7

  • 添加了思维块预览“晕影”,可在聊天外观设置中选择禁用
  • 将“Qwen3 Embedding”模型的默认域设置为文本嵌入 (Text Embedding)
  • lms chat 命令添加了 --stats 参数,用于显示预测统计信息(感谢 @Yorkie
  • [Windows][ROCm] 支持 Strix Halo (AMD Ryzen AI PRO 300 系列)
  • [Windows] 在硬件页面添加 CPU 名称

版本 6

  • 在工具调用参数令牌生成时将其流式传输到 UI
  • 修复了模型生成时向上滚动的问题
  • 修复了工具权限对话框无法自动滚动到聊天底部的错误

版本 5

  • 为减少新用户困惑,“更改角色”和“插入”按钮在默认安装中将处于隐藏状态。您可以右键点击发送按钮来切换它们的显示。
  • 修复了不提供参数对象的 MCP 工具无法正常工作的错误。
  • 修复了 MCP 服务器重新加载时会导致持续进行的工具调用无限挂起的错误。

版本 4

  • [MCP 测试版] 修复了工具调用参数包含数组或对象时崩溃的问题

版本 3

  • 修复了引擎更新有时会卡住的错误

版本 2

  • 提高了全尺寸 DeepSeek-R1 工具调用的可靠性
  • 添加了将下载面板弹出到新窗口的按钮。

版本 1

  • 新主题:Solarized Dark
    • 在“设置 > 常规”中进行设置,或按下 [⌘/Ctrl K + T]
  • 修复了模型目录的时间戳、喜欢、下载排序不符合预期的问题。
  • 修复了模型删除对话框中的占位符文本。
  • 修复了 Windows 上显示 MLX 模型的问题。
  • 修复了无聊天页面上标题栏重新出现的问题。
  • 修复了快速退出时删除聊天对话框会阻塞聊天 UI 的错误。