🚀 Claude-LMStudio 桥接工具

Claude-LMStudio 桥接工具是一个 MCP 服务器，它能将 Claude 与本地运行在 LM Studio 中的大语言模型（LLM）连接起来，让您可以借助本地模型在 Claude 中实现文本生成、对话完成等功能。

🚀 快速开始

推荐安装方式

对于 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

✨ 主要特性

• 模型列表展示：可列出 LM Studio 中所有可用的模型。
• 文本生成能力：使用您的本地 LLM 生成文本。
• 对话完成支持：支持通过本地模型进行对话完成。
• 健康检查工具：用于验证与 LM Studio 的连接状态。

💻 使用示例

基础用法

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

1. 检查 LM Studio 的连接状态

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

2. 列出可用的模型

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

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

生成一首关于春天的简短诗歌

4. 发送对话完成请求

向我的本地 LLM 询问：“机器学习中转换器的主要功能是什么？”

🔧 技术细节

故障排除

诊断 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 许可证。