← 返回博客

LM Studio 中的 MCP

作者
LM Studio 团队

•

2025-06-25

LM Studio 0.3.17 引入了 模型上下文协议 (MCP) 支持，允许您将喜爱的 MCP 服务器连接到应用程序，并与本地模型配合使用。

undefined

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

此版本的其他更新

  • 感谢社区本地化贡献者，新增对 11 种语言的支持。LM Studio 现在支持 33 种语言。
  • 修复了大量错误，并改进了 UI，包括新增主题：“Solarized Dark”。
通过应用内更新或从 https://lm-studio.cn/download 升级。

向 LM Studio 添加 MCP 服务器

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

术语

  • “MCP 服务器” (MCP Server)：提供工具和资源访问权限的程序。例如 Stripe、GitHub 或 Notion 开发了 MCP 服务器。
  • “MCP 主机” (MCP Host)：可以连接到 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 服务器提供对模型和数据集搜索等功能的访问。

Add MCP Server hf-mcp-server to LM Studio
 
{
  "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 服务器启动一个单独的进程。

  • 对于依赖 npx 或 uvx（或机器上任何其他程序）的本地 MCP 服务器，您需要确保这些工具已安装并可在系统的 PATH 中访问。

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

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

开发者：创建一个“添加到 LM Studio”按钮

我们还推出了一种使用深度链接 (deeplink) 按钮一键将 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 - 完整发布说明

Build 10

  • 添加了“聊天外观”设置，用于选择消息生成统计信息的显示方式：仅在最后一条消息显示、仅在工具提示中显示或在所有适用消息上显示
  • Token 计数现在包含系统提示词和工具定义
  • 对于内容中包含 URL 的 LLM 消息，显示“在浏览器中打开”按钮。
    • 请注意：LLM 可能会生成不受信任的 URL。点击前请务必核实链接。

Build 9

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

Build 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 Beta] 修复了当工具调用的参数包含数组或对象时崩溃的问题

版本 3

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

版本 2

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

版本 1

  • 新主题：Solarized Dark。
    • 可在“设置 > 通用”中设置，或按 [⌘/Ctrl K + T] 快捷键设置
  • 修复了模型目录的时间戳、点赞数、下载量排序无法按预期工作的问题。
  • 修复了模型删除对话框中的占位符文本。
  • 修复了 MLX 模型在 Windows 上显示的问题。
  • 修复了顶部标题栏在“无聊天”页面重新出现的错误。
  • 修复了快速退出删除聊天对话框时可能导致聊天 UI 锁定的错误。