Claude-LMStudio 桥接

一个将 Claude 与在 LM Studio 中运行的本地 LLM 连接起来的 MCP 服务器。

概述

此工具允许 Claude 与在 LM Studio 中运行的本地 LLM 交互，提供：

• 访问 LM Studio 中所有可用模型的列表
• 使用本地 LLM 生成文本的能力
• 通过本地模型支持聊天补全
• 用于验证与 LM Studio 连接的健康检查工具

前提条件

• 支持 MCP 的 Claude Desktop
• 已安装并在本地运行且启用了 API 服务器的 LM Studio
• 已安装 Python 3.8+

快速开始（推荐）

对于 macOS/Linux：

1. 克隆存储库

git clone https://github.com/infinitimeless/claude-lmstudio-bridge.git
cd claude-lmstudio-bridge

2. 运行设置脚本

chmod +x setup.sh
./setup.sh

3. 按照设置脚本的说明配置 Claude Desktop

对于 Windows：

1. 克隆存储库

git clone https://github.com/infinitimeless/claude-lmstudio-bridge.git
cd claude-lmstudio-bridge

2. 运行设置脚本

setup.bat

3. 按照设置脚本的说明配置 Claude Desktop

手动设置

如果您喜欢手动设置：

1. 创建一个虚拟环境（可选但推荐）

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate

2. 安装所需的包

pip install -r requirements.txt

3. 配置 Claude Desktop：
   • 打开 Claude Desktop 首选项
   • 导航到“MCP 服务器”部分
   • 添加一个新的 MCP 服务器，配置如下：
     • 名称: lmstudio-bridge
     • 命令: /bin/bash (在 macOS/Linux 上) 或 cmd.exe (在 Windows 上)
     • 参数:
       • macOS/Linux: /path/to/claude-lmstudio-bridge/run_server.sh
       • Windows: /c C:\path\to\claude-lmstudio-bridge\run_server.bat

在 Claude 中使用

设置好桥接后，您可以在 Claude 中使用以下命令：

1. 检查与 LM Studio 的连接：

你能检查一下我的 LM Studio 服务器是否正在运行吗？

2. 列出可用模型：

列出我的本地 LM Studio 中可用的模型

3. 使用本地模型生成文本：

使用我的本地 LLM 生成一首关于春天的短诗

4. 发送聊天补全：

问我的本地 LLM：“机器学习中 transformers 的主要特点是什么？”

故障排除

诊断 LM Studio 连接问题

使用包含的调试工具检查您的 LM Studio 连接：

python debug_lmstudio.py

进行更详细的测试：

python debug_lmstudio.py --test-chat --verbose

常见问题

“无法连接到 LM Studio API”

• 确保 LM Studio 正在运行
• 验证 LM Studio 中是否启用了 API 服务器（设置 > API 服务器）
• 检查端口（默认：1234）是否与您的 .env 文件中的端口匹配

“未加载任何模型”

• 打开 LM Studio 并加载一个模型
• 验证模型是否成功运行

“找不到 MCP 包”

• 尝试重新安装：pip install "mcp[cli]" httpx python-dotenv
• 确保您使用的是 Python 3.8 或更高版本

“Claude 找不到桥接”

• 检查 Claude Desktop 配置
• 确保 run_server.sh 或 run_server.bat 的路径正确且绝对
• 验证服务器脚本是否可执行：chmod +x run_server.sh (在 macOS/Linux 上)

高级配置

您可以通过创建一个包含以下设置的 .env 文件来自定义桥接行为：

LMSTUDIO_HOST=127.0.0.1
LMSTUDIO_PORT=1234
DEBUG=false

设置 DEBUG=true 以启用详细日志记录以进行故障排除。

许可证

MIT