Claude Lmstudio Bridge

🚀 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 許可證。