Claude Lmstudio Bridge

🚀 Claude-LMStudio 橋接ツール

このツールは、Claude とローカルで LM Studio 上で動作する大規模言語モデル（LLM）を接続する MCP サーバーです。

🚀 クイックスタート

このツールを使用すると、Claude がローカルで LM Studio 上で動作する LLM にアクセスできるようになり、以下の機能を提供します。

• LM Studio で利用可能なすべてのモデルを一覧表示する
• ローカルの LLM を使用してテキストを生成する
• ローカルモデルを通じた対話の完了をサポートする
• LM Studio との接続状態を検証するヘルスチェックツール

📦 インストール

前提条件

• MCP をサポートする Claude Desktop をインストールし、起動する
• LM Studio をインストールし、起動し、API サーバーを有効にする
• 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 で以下のコマンドを使用できます。

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