Lmstudio MCP

🚀 LMStudio-MCP サーバー

このサーバーは、モデル制御プロトコル（MCP）を利用し、Claude が LM Studio を通じてローカルで実行されている大規模言語モデル（LLM）と通信できるようにします。

🚀 クイックスタート

LMStudio-MCP は、Claude（MCP 機能を備えたもの）とローカルで実行されている LM Studio インスタンスをつなぐ橋渡しを行います。これにより、Claude は以下のことが可能になります。

• LM Studio API のヘルスチェック
• 利用可能なすべてのモデルのリスト表示
• 現在ロードされているモデルの取得
• ローカルモデルを使用したテキスト生成

これにより、Claude の機能と独自のプライベートモデルを組み合わせ、ローカルで実行されているモデルを最大限に活用することができます。

✨ 主な機能

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

📦 インストール

前提条件

• Python 3.7 以上
• インストール済みで実行中の LM Studio
• LM Studio にモデルがロードされていること
• MCP アクセス権を持つ Claude
• 必要な Python パッケージ（インストールを参照）

インストール手順

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

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

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

   pip install requests "mcp[cli]" openai
   

📚 ドキュメント

MCP 設定

Claude がこの橋渡しに接続できるようにするには、MCP 設定を正しく構成する必要があります。以下の 2 つの方法があります。

GitHub から直接使用する場合

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

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

{
  "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 サーバーに接続します。

既知の制限事項

• 一部のモデル（例: phi-3.5-mini-instruct）で問題が発生する場合があります。
• ファイルサイズが 20MB を超えるモデルはサポートされていません。
• 大きなモデルの場合、ロード時間が長くなる可能性があります。

トラブルシューティング

問題が発生した場合は、以下の点を確認してください。

1. LM Studio が正しくインストールされ、デフォルトのポート（1234）で実行されていることを確認します。
2. ファイアウォールやネットワーク制限がポートへのアクセスを妨げていないことを確認します。
3. モデルが LM Studio に正常にロードされていることを検証します。
4. LM Studio のコンソール出力を確認して、詳細情報を取得します。

詳細については、トラブルシューティングガイド を参照してください。

📄 ライセンス

貢献者

• 作者：[あなたの名前]
• その他の貢献者：...

このプロジェクトに貢献してくれたすべての方に感謝します！