LM Studio

🚀 LMStudio-MCP プロジェクトドキュメント

LMStudio-MCP は、Claude（MCP 機能付き）とローカルで実行されている LM Studio インスタンスを接続する橋渡しを行います。これにより、Claude は以下のことができます。

• LM Studio API のヘルスチェックを行う
• 利用可能なモデルを一覧表示する
• 現在ロードされているモデルを取得する
• ローカルのモデルを使用して完成語を生成する

この橋渡しにより、Claude の機能を独自のプライベートモデルと組み合わせて使用することができます。

🚀 クイックスタート

前提条件

• Python 3.7 以上
• LM Studio がインストールされ、実行されていること（https://lmstudio.ai/）
• LM Studio にモデルがロードされていること
• Claude が MCP アクセス権を持っていること
• 必要な Python パッケージ（インストールを参照）

📦 インストール

1. このリポジトリをクローンします。

   git clone https://github.com/infinitimeless/LMStudio-MCP.git
   cd LMStudio-MCP
   

2. 必要なパッケージをインストールします。

   pip install requests "mcp[cli]" openai
   

MCP 設定

Claude をこの橋渡しに接続するには、MCP 設定を正しく構成する必要があります。以下のいずれかの方法を選択できます。

1. GitHub から直接使用する場合

   {
     "lmstudio-mcp": {
       "command": "uvx",
       "args": [
         "https://github.com/infinitimeless/LMStudio-MCP"
       ]
     }
   }
   

2. ローカルインストールを使用する場合

   {
     "lmstudio-mcp": {
       "command": "/bin/bash",
       "args": [
         "-c",
         "cd /path/to/LMStudio-MCP && source venv/bin/activate && python lmstudio_bridge.py"
       ]
     }
   }
   

MCP 設定の詳細については、MCP_CONFIGURATION.md を参照してください。

💻 使用例

1. LM Studio アプリケーションを起動し、デフォルトポート 1234 で実行されていることを確認します。

2. LM Studio でモデルをロードします。

3. ローカルで実行する場合（uvx を使用しない場合）、LMStudio-MCP サーバーを起動します。

   python lmstudio_bridge.py
   

4. Claude で、"lmstudio-mcp" を選択して MCP サーバーに接続します。

✨ 主な機能

この橋渡しは以下の機能を提供します。

• health_check()：LM Studio API がアクセス可能かどうかを検証する
• list_models()：LM Studio で利用可能なすべてのモデルのリストを取得する
• get_current_model()：現在ロードされているモデルを識別する
• chat_completion(prompt, system_prompt, temperature, max_tokens)：ローカルのモデルからテキストを生成する

既知の制限

• 一部のモデル（例：phi-3.5-mini-instruct_uncensored）には互換性の問題がある場合があります。
• この橋渡しは現在、LM Studio の OpenAI 互換 API エンドポイントのみを使用しています。
• モデルの応答は、ロードしたローカルモデルの能力に制限されます。

トラブルシューティング

API 接続問題

Claude が 404 エラーを報告し、LM Studio に接続できない場合：

• LM Studio が実行されており、モデルがロードされていることを確認します。
• LM Studio のサーバーがポート 1234 で実行されていることを確認します。
• ファイアウォールが接続をブロックしていないことを確認します。
• 問題が解決しない場合は、API URL で "localhost" の代わりに "127.0.0.1" を使用してみてください。

モデル互換性

一部のモデルが正常に動作しない場合：

• 使用しているモデルが LM Studio と互換性があることを確認します。
• MCP_CONFIGURATION.md を参照して詳細を確認してください。

その他のトラブルシューティング手順については、TROUBLESHOOTING.md を参照してください。

注意事項

⚠️ 重要提示

このプロジェクトはまだ開発段階であり、不安定または機能が不完全な場合があります。使用する前に関連ドキュメントをよく読み、重要なデータをバックアップしてください。