MCP in LM Studio

原始链接: https://lmstudio.ai/blog/lmstudio-v0.3.17

LM Studio 0.3.17 introduces Model Context Protocol (MCP) support, enabling connection to MCP servers for enhanced LLM functionality with tools and resources. Users can add local or remote MCP servers via `mcp.json` editing or the "Add to LM Studio" button. A Hugging Face MCP server example is provided, emphasizing security cautions when installing MCPs. Tool calls require user confirmation with options to always allow, deny, or allow once. Other updates include: * Support for 11 new languages. * "Solarized Dark" theme. * Deeplink button for easy MCP server installation. * Various bug fixes and UI improvements. * Displaying message generation stats, opening URLs, system prompt editor shortcut, and pinning the downloads panel. Version 0.3.17 improves tool call handling, UI, and overall user experience.

LM Studio，一款运行本地大型语言模型 (LLM) 的工具，正在迅速普及，尤其是在苹果硅芯片的 Mac 上，这得益于其用户友好的界面和对 MLX 模型的支持。一些用户甚至投资购买高端硬件，例如 Mac Studio，以最大限度地提升其性能。讨论中强调了 LM Studio 与基于命令行的替代方案（如 vllm/ollama）相比的优势，特别是它能够自定义输出设置的能力。然而，其闭源性质和一些用户认为过于花哨的 UI 也成为争议点。最近加入的 MCP（模型上下文协议）支持也成为讨论话题。一些人认为它对于利用“工具即服务 (Tools as a Service)”非常有用，另一些人则认为它是一个寻找问题的解决方案，本质上是对现有“工具”模式的重新包装。像 Open WebUI 这样的替代方案也被提及，它可以与 Ollama 等后端集成，并提供类似的功能。对话还涉及到运行大型模型所需的 RAM 和 VRAM 的重要性，以及在本地网络上运行 LLM 的挑战。

LM Studio 0.3.17 introduces Model Context Protocol (MCP) support, allowing you to connect your favorite MCP servers to the app and use them with local models.

LM Studio supports both local and remote MCP servers. You can add MCPs by editing the app's mcp.json file or via the new "Add to LM Studio" Button, when available.

Also new in this release:

Support for 11 new languages, thanks to our community localizers. LM Studio is now available in 33 languages.
Many bug fixes, as well as improvements to the UI, including a new theme: 'Solarized Dark'.

Upgrade via in-app update, or from https://lmstudio.ai/download.

Model Context Protocol (MCP) is a set of interfaces for providing LLMs access to tools and other resources. It was originally introduced by Anthropic, and is developed on Github.

Terminology:

"MCP Server": program that provides tools and access to resources. For example Stripe, GitHub, or Notion make MCP servers.
"MCP Host": applications (like LM Studio or Claude Desktop) that can connect to MCP servers, and make their resources available to models.

Install new servers: `mcp.json`

Switch to the "Program" tab in the right hand sidebar. Click Install > Edit mcp.json.

This will open the mcp.json file in the in-app editor. You can add MCP servers by editing this file.

Edit mcp.json using the in-app editor

LM Studio currently follows Cursor's mcp.json notation.

Example MCP to try: Hugging Face MCP Server

This MCP server provides access to functions like model and dataset search.

{
  "mcpServers": {
    "hf-mcp-server": {
      "url": "https://huggingface.co/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_HF_TOKEN>"
      }
    }
  }
}

You will need to replace `<YOUR_HF_TOKEN>` with your actual Hugging Face token. Learn more here.

Be cautious

Never install MCPs from untrusted sources.

Some MCP servers can run arbitrary code, access your local files, and use your network connection. Always be cautious when installing and using MCP servers. If you don't trust the source, don't install it.

When a model calls a tool, LM Studio will show a confirmation dialog to the user. This allows you to review the tool call arguments before executing it, including editing the arguments if needed.

Tool call confirmation dialog

You can choose to always allow a given tool, always deny it, or allow it only once.

If you choose to always allow a tool, LM Studio will not show the confirmation dialog for that tool in the future. You can manage this later in App Settings > Tools & Integrations.

MCP support: more technical details

When you save the mcp.json file, LM Studio will automatically load the MCP servers defined in it. We spawn a separate process for each MCP server.
For local MCP servers that rely on npx or uvx (or any other program on your machine), you need to ensure those tools are installed and available in your system's PATH.
mcp.json lives in ~/.lmstudio/mcp.json on macOS and Linux, and in %USERPROFILE%/.lmstudio/mcp.json on Windows. It's recommended to use the in-app editor to edit this file.

If you're running into bugs, please open an issue on our bug tracker: https://github.com/lmstudio-ai/lmstudio-bug-tracker/issues.

We're also introducing a one-click way to add MCP servers to LM Studio using a deeplink button.

Install link generator

Enter your MCP JSON entry to generate a deeplink for the Add to LM Studio button.

👇 This is a real interactive tool that you can use to create your own MCP install links. Try it!

<div class="flex w-full flex-col gap-0"><p><span class="opacity-70">No MCP Server Detected</span></p><p><button class="border inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 transition-all duration-[250ms] ease-in-out bg-panel dark:text-accent-foreground dark:bg-accent border-accent-border hover:bg-accent/80 hover:text-accent-foreground h-10 px-4 py-2">Markdown</button><button class="border inline-flex items-center justify-center whitespace-nowrap rounded-md text-sm font-medium ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 transition-all duration-[250ms] ease-in-out hover:text-accent-foreground hover:bg-accent h-10 px-4 py-2">HTML</button></p><div class="flex flex-col items-center justify-center gap-4 pt-3" readability="6"><div class="text-muted-foreground w-full justify-center text-center text-sm" readability="32"><p>Click on the button to copy the Markdown to clipboard.</p></div></div></div></div></div>
<h4>Example</h4>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]">Try to copy and paste the following into the link generator above.</p>
<pre dir="ltr" class="relative flex rounded-md border !relative !px-2 !py-4 !text-[17px] !bg-[#fcfcfc] dark:!bg-[#2d2c2f] whitespace-normal h-full w-full bg-transparent px-[1px]"><div class="relative flex w-full overflow-x-auto pr-9" readability="7"><div class="[&>pre]:mb-0 [&>pre]:p-0" readability="9"><pre class="shiki shiki-themes min-light one-dark-pro" tabindex="0"><code><span class="line"><span>{</span></span>
<span class="line"><span>  "hf-mcp-server"</span><span>:</span><span> {</span></span>
<span class="line"><span>    "url"</span><span>:</span><span> "https://huggingface.co/mcp"</span><span>,</span></span>
<span class="line"><span>    "headers"</span><span>:</span><span> {</span></span>
<span class="line"><span>      "Authorization"</span><span>:</span><span> "Bearer <YOUR_HF_TOKEN>"</span></span>
<span class="line"><span>    }</span></span>
<span class="line"><span>  }</span></span>
<span class="line"><span>}</span></span>
<span class="line"/></code></pre></div></div><button class="justify-center whitespace-nowrap text-sm font-medium ring-offset-background focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 disabled:pointer-events-none disabled:opacity-50 transition-all duration-[250ms] ease-in-out text-primary-foreground border h-8 rounded-md px-3 bg-background hover:bg-background/50 hover:text-foreground absolute right-2 top-2.5 flex flex-none items-center !p-0 !h-7 !w-7" aria-label="Copy code"><svg xmlns="http://www.w3.org/2000/svg" stroke="currentColor" fill="none" stroke-width="2" viewbox="0 0 24 24" stroke-linecap="round" stroke-linejoin="round" height="1em" width="1em"><rect x="9" y="9" width="13" height="13" rx="2" ry="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg></button></pre>
<h6>You will need to replace <code class="whitespace-nowrap" dir="ltr"><YOUR_HF_TOKEN></code> with your actual Hugging Face token. Learn more <a href="https://huggingface.co/docs/hub/en/security-tokens" node="[object Object]" target="_blank" rel="noopener noreferrer">here</a>.</h6>
<h2 id="one-more-thing" node="[object Object]" class="flex w-full flex-row items-center justify-start gap-2 m-0 border-none p-0"><span class="">One more thing...</span><a href="#one-more-thing" class="text-sm text-foreground/60" aria-label="Link to this section" title="Link to 'One more thing...'"><svg xmlns="http://www.w3.org/2000/svg" stroke="currentColor" fill="none" stroke-width="2" viewbox="0 0 24 24" stroke-linecap="round" stroke-linejoin="round" class="text-xl transition duration-200 ease-in-out opacity-0 hover:opacity-100" height="1em" width="1em"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg></a></h2>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]">Connecting MCP servers is easy. But what about creating your own tools and custom resources for your models? Stay tuned... 👾</p>
<br/>
<hr node="[object Object]" class="my-5"/>
<h2 id="0317---full-release-notes" node="[object Object]" class="flex w-full flex-row items-center justify-start gap-2 m-0 border-none p-0"><span class="">0.3.17 - Full Release Notes</span><a href="#0317---full-release-notes" class="text-sm text-foreground/60" aria-label="Link to this section" title="Link to '0.3.17 - Full Release Notes'"><svg xmlns="http://www.w3.org/2000/svg" stroke="currentColor" fill="none" stroke-width="2" viewbox="0 0 24 24" stroke-linecap="round" stroke-linejoin="round" class="text-xl transition duration-200 ease-in-out opacity-0 hover:opacity-100" height="1em" width="1em"><path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/></svg></a></h2>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 10</strong></p>
<ul node="[object Object]" class="list-disc">
<li>Added a Chat Appearance setting to display message generation stats on last message only, in tooltips only, or on all applicable messages</li>
<li>Token count now includes system prompt & tool definitions</li>
<li>Show 'open in browser' button for LLM messages that have a URL in the content.
<ul node="[object Object]" class="list-disc">
<li>Be mindful: LLMs may generate untrusted URLs. Always verify links before clicking.</li>
</ul>
</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 9</strong></p>
<ul node="[object Object]" class="list-disc">
<li>Enable MCP by default</li>
<li><code class="whitespace-nowrap" dir="ltr">Cmd + Shift + E</code> on Mac or <code class="whitespace-nowrap" dir="ltr">Ctrl + Shift + E</code> on PC always opens the system prompt editor for the current chat</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 8</strong></p>
<ul node="[object Object]" class="list-disc">
<li>When download panel is open in a new window, add an option to pin it on top of other windows (right click the body)</li>
<li>Adds the following languages, thanks to our community localizers!

</li>
<li>Fixed a bug where entries may be duplicated when selecting a draft model for speculative decoding</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 7</strong></p>
<ul node="[object Object]" class="list-disc">
<li>Added thinking block preview 'vignette', with an option to disable in chat appearance settings</li>
<li>Set default domain for "Qwen3 Embedding" models to Text Embedding</li>
<li>Added <code class="whitespace-nowrap" dir="ltr">--stats</code> command to <code class="whitespace-nowrap" dir="ltr">lms chat</code> command to show prediction statistics (<a href="https://github.com/lmstudio-ai/lms/pull/250" node="[object Object]" target="_blank" rel="noopener noreferrer">Thanks @Yorkie</a>)</li>
<li>[Windows][ROCm] Strix Halo (AMD Ryzen AI PRO 300 series) support</li>
<li>[Windows] Add CPU name to hardware page</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 6</strong></p>
<ul node="[object Object]" class="list-disc">
<li>Stream tool call argument tokens to the UI as they are generated</li>
<li>Fixed bugs with scrolling up while the model is generating</li>
<li>Fixed a bug where tool permission dialog wouldn't auto-scroll to the bottom of the chat</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 5</strong></p>
<ul node="[object Object]" class="list-disc">
<li>To reduce new user confusion, the "change role" and "insert" buttons will now be hidden by default on new installs. You can right click the send button to toggle them on or off.</li>
<li>Fixed a bug where MCP tools that don't provide a parameters objects would not work correctly.</li>
<li>Fixed a bug where if MCP server reloaded, the ongoing tool calls would hang indefinitely.</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 4</strong></p>
<ul node="[object Object]" class="list-disc">
<li>[MCP Beta] Fixes crash when arguments of a tool call contains arrays or objects</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 3</strong></p>
<ul node="[object Object]" class="list-disc">
<li>Fixed a bug where engine updates can sometimes get stuck</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 2</strong></p>
<ul node="[object Object]" class="list-disc">
<li>Improved full-sized DeepSeek-R1 tool calling reliability</li>
<li>Button to pop out downloads panel to a new window.</li>
</ul>
<p class="text-foreground/90 h-full w-full bg-transparent px-[1px]"><strong>Build 1</strong></p>
<ul node="[object Object]" class="list-disc">
<li>New Theme: <strong>Solarized Dark</strong>.
<ul node="[object Object]" class="list-disc">
<li>Set it in Settings > General or by pressing <code class="whitespace-nowrap" dir="ltr">[⌘/Ctrl K + T]</code></li>
</ul>
</li>
<li>Fixed model catalog timestamp, likes, downloads sorting not working as expected.</li>
<li>Fixed placeholder text in model deletion dialog.</li>
<li>Fixed MLX models showing up on Windows.</li>
<li>Fixed a bug with the header bar reappearing on the no chats page.</li>
<li>Fixed a bug where delete chat dialog block chat UI if quickly escaped.</li>
</ul></div>        </div>
    </div>
</div>
<div class='clear'></div>    </div>
    <div style='position:fixed; bottom:0; left:0; right:0;'>
        </div>
    <div align='center' style='border-top:1px solid #EEE; padding:1em; margin-top:2em;'>
  联系我们 contact @ memedata.com
</div>

<script async src="https://www.googletagmanager.com/gtag/js?id=G-PFMR8YTWGP"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

gtag('config', 'G-PFMR8YTWGP');
</script>
</body>
</html>