解锁本地大模型新玩法:手把手教你配置MCP,打造专属点歌神器

2025年7月1日

本文旨在帮助更好地了解MCP工具服务器。本文主要聚焦于使用STDIO传输协议的本地MCP服务器工具,暂不涉及授权或安全性问题。

什么是MCP服务器?

简单来说,MCP服务器就是一个脚本,它会持续监听来自大模型的调用。一旦接收到调用,它就会执行相应的操作,并将结果返回给大模型。MCP服务器可以完成多种任务,但本文的重点是工具。

什么是工具?

工具是一种特殊的功能,大模型可以激活它,指示运行服务器的计算机执行特定操作,例如访问文件、调用Web API或向数据库添加条目。

理论上,只要的计算机能做到的事情,都可以通过工具来实现。

这不会有安全风险吗?

别担心!大模型并不能随心所欲地执行任何操作,它只能访问明确提供给它的工具。此外,客户端会在任何工具实际运行之前,先征求用户的确认。所以,大可不必过于忧虑!

能举个例子吗?

当然!我制作了一个名为"llm-jukebox"的MCP服务器作为演示。它能让大模型帮从YouTube下载歌曲。只需提出下载歌曲的请求,它就会自动在YouTube上搜索、找到并下载视频,然后将视频转换为MP3格式。

可以点击这里查看它的运行效果。

前提配置

没问题!一旦准备好所需的一切,安装过程其实相当简单。需要具备以下几项:

  • 能作为MCP客户端的大模型前端:目前LM Studio和Jan都支持此功能。如果知道其他类似的软件,请告诉我,我会将其添加到列表中。

  • 能处理工具调用的模型:Qwen 3和Gemma 3是目前比较好的选择。如果了解其他兼容模型,也请告诉我,我会一并更新列表。

  • Python、UV和NPM:这些是大多数MCP服务器所使用的脚本语言的运行环境。

  • 一点点动手能力:需要会使用终端并编辑JSON文件。这并不难,可以的!当然,也可以向大模型寻求帮助,但由于MCP相对较新,大多数大模型在这方面的表现还不太理想。

  • 一个服务器:可以直接使用我提供的服务器!

LM Studio配置llm-jukebox服务器教程

以下是让llm-jukebox服务器在LM Studio中运行的分步指南。请注意,需要安装最新版本的LM Studio,因为MCP支持是最近才添加的。

  1. 克隆代码库或下载并解压ZIP文件。
  2. 如果尚未安装UV,请点击这里下载并安装
  3. 确保的系统安装了ffmpeg。在Windows中,打开终端并输入winget install ffmpeg;在Ubuntu或Debian中,运行sudo apt install ffmpeg
  4. 确保正在使用的模型经过了Properly Tool Handling训练。Qwen 3和Gemma 3是不错的选择。
  5. 在LM Studio中,依次点击"开发者模式"、"程序"、"工具和集成",然后点击"安装"按钮旁边的箭头,选择"编辑mcp.json"。在mcpServers下添加以下条目:

注意1:JSON格式非常严谨,哪怕是一个逗号的错误都可能导致程序无法运行。请务必仔细核对,确保除了路径之外,其他内容都完全一致。

注意2:JSON文件中不能使用反斜杠。因此,Windows路径需要将反斜杠替换为正斜杠。替换后依然可以正常工作。

"llm-jukebox": {
  "command": "uv",
  "args": [
    "run",
    "c:/path/to/llm-jukebox/server.py"
  ],
  "env": {
    "DOWNLOAD_PATH": "c:/path/to/downloads"
  }
}

请务必将上述路径更改为的代码库实际存放位置以及希望下载文件保存的路径。

如果没有其他条目,完整的JSON文件内容应大致如下所示:

{
  "mcpServers": {
    "llm-jukebox": {
      "command": "uv",
      "args": [
        "run",
        "c:/users/user/llm-jukebox/server.py"
      ],
      "env": {
        "DOWNLOAD_PATH": "c:/users/user/downloads"
      }
    }
  }
}

点击"保存"按钮或按下Ctrl+S。如果配置成功,应该就能通过滑动开关启用llm-jukebox了。

现在,可以开始让大模型帮下载歌曲了!