文档

模型上下文协议 (MCP)

使用 MCP 服务器

将 MCP 服务器连接到 LM Studio

从 LM Studio 0.3.17 版本开始,LM Studio 可作为 模型上下文协议 (MCP) 主机运行。这意味着您可以将 MCP 服务器连接到应用,并供您的模型使用。

保持谨慎

切勿安装来源不明的 MCP。

注意

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

在 LM Studio 中使用 MCP 服务器

从 0.3.17 (b10) 版本开始,LM Studio 支持本地和远程 MCP 服务器。您可以通过编辑应用的 mcp.json 文件,或者在可用时通过 “添加到 LM Studio”按钮来添加 MCP。LM Studio 目前遵循 Cursor 的 mcp.json 规范。

安装新服务器:mcp.json

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

undefined

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

undefined

使用应用内编辑器编辑 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 令牌。了解更多信息请点击这里

使用 深层链接按钮,或复制上面的 JSON 片段并将其粘贴到您的 mcp.json 文件中。


注意事项与故障排除

  • 切勿安装来源不明的 MCP 服务器。一些 MCP 可能对您的系统拥有广泛的访问权限。

  • 某些 MCP 服务器是为 Claude、ChatGPT、Gemini 等设计的,可能会消耗过多的 Token。

    • 请留意这一点。它可能会迅速拖慢您的本地模型,并导致频繁的上下文溢出。
  • 手动添加 MCP 服务器时,请仅复制 "mcpServers": { 之后以及右花括号 } 之前的内容。

此页面源代码可在 GitHub 上查看