Claude-LMStudio Bridge
2025.03.21
2
Python本地模型连接文本生成聊天完成开发效率
Claude-LMStudio Bridge 是一个 MCP 服务器，用于连接 Claude 与本地在 LM Studio 中运行的大型语言模型（LLM）。该工具提供了访问本地 LLM 的能力，包括列出可用模型、生成文本、支持聊天完成等功能。
View on GitHub
Overview
基本能力
产品定位
Claude-LMStudio Bridge 是一个桥梁工具，旨在将 Claude 与本地运行的 LM Studio 中的大型语言模型（LLM）连接起来，提供本地模型访问和文本生成能力。
核心功能
- 访问并列出 LM Studio 中所有可用模型
- 使用本地 LLM 生成文本
- 支持通过本地模型进行聊天完成
- 提供健康检查工具以验证与 LM Studio 的连接
适用场景
- 开发者希望在 Claude 中使用本地 LLM 进行文本生成
- 需要本地模型支持的聊天应用
- 调试和测试本地 LLM 的功能
工具列表
debug_lmstudio.py: 用于诊断 LM Studio 连接问题的调试工具run_server.sh/run_server.bat: 启动 MCP 服务器的脚本
常见问题解答
- "Cannot connect to LM Studio API": 确保 LM Studio 正在运行，API 服务器已启用，端口匹配
- "No models are loaded": 在 LM Studio 中加载模型并验证其运行状态
- "MCP package not found": 重新安装 MCP 包并确保使用 Python 3.8 或更高版本
- "Claude can't find the bridge": 检查 Claude Desktop 配置，确保服务器脚本路径正确且可执行
使用教程
使用依赖
- Claude Desktop 支持 MCP
- LM Studio 已安装并运行，且启用了 API 服务器
- Python 3.8+ 已安装
安装教程
macOS/Linux:
- 克隆仓库
git clone https://github.com/infinitimeless/claude-lmstudio-bridge.git
cd claude-lmstudio-bridge
- 运行安装脚本
chmod +x setup.sh
./setup.sh
- 按照安装脚本的指示配置 Claude Desktop
Windows:
- 克隆仓库
git clone https://github.com/infinitimeless/claude-lmstudio-bridge.git
cd claude-lmstudio-bridge
- 运行安装脚本
setup.bat
- 按照安装脚本的指示配置 Claude Desktop
调试方式
使用调试工具检查 LM Studio 连接:
python debug_lmstudio.py
详细测试:
python debug_lmstudio.py --test-chat --verbose