Claude Desktop API USE VIA MCP

🚀 MCPを通じたClaude Desktop APIの統合実現

このプロジェクトは、Claude DesktopとClaude APIのシームレスな統合を可能にするMCPサーバーの実装を提供します。これにより、プロフェッショナルプランの制限を回避し、カスタムシステムプロンプトや会話管理などの高度な機能にアクセスできます。

✨ 主な機能

• MCPを通じて直接Claude APIを統合
• 会話履歴の追跡と管理
• システムプロンプトのサポート
• プロフェッショナルプランとAPIの使用をシームレスに切り替え
• Claude Desktopを使用した簡単な設定

📦 インストール

設定手順

1. リポジトリをクローンする

   # VS Codeを使用する場合：
   # 1. Cmd + Shift + Pを押す
   # 2.「Git: Clone」を入力
   # 3. 以下を貼り付ける：https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
   
   # またはターミナルを使用する場合：
   git clone https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
   cd Claude_Desktop_API_USE_VIA_MCP
   

2. 依存関係をインストールする

   pip install -r requirements.txt
   

3. 環境を設定する

   # 環境変数テンプレートをコピーする
   cp .env.example .env
   
   # .envを編集し、APIキーを追加する
   ANTHROPIC_API_KEY=your_api_key_here
   

4. Claude Desktopを設定する

   • macOS：~/Library/Application Support/Claude/に移動

     # Finderを使用する場合：
     # 1. Cmd + Shift + Gを押す
     # 2. 以下を入力：~/Library/Application Support/Claude/
     

   • Windows：%APPDATA%\Claude\に移動
   • claude_desktop_config.jsonを作成または編集
   • config/claude_desktop_config.jsonの内容をコピー
   • パスとAPIキーを更新

💻 使用例

基本的な使用法

1. 通常のClaude Desktopの使用

   • Claudeと通常通りチャットする
   • プロフェッショナルプランの範囲内で基本的な操作を行う
   • 特別な設定は不要

2. MCPサーバーを通じたClaude APIの使用

   • 設定が完了したら、MCPサーバーを起動する
   • Claude Desktopを使用してAPI機能を呼び出す
   • ドキュメントの例に従って操作する

高度な使用法

• カスタムシステムプロンプト：

  • config/system_prompt.jsonを編集する
  • プロンプト内容を追加または変更する
  • 変更を適用するためにサービスを再起動する

• 会話履歴管理：

  • 提供されたAPIを使用して会話記録を照会および管理する
  • 時間、トピックなどの条件でフィルタリングをサポートする
  • 詳細な会話コンテキストを提供する

📚 ドキュメント

適用シーン

• プロフェッショナルプラン（デフォルト）：

  • Claude Desktopで通常の会話を行う
  • プランの制限内で基本的な使用を行う
  • 特別な設定は不要

• APIトークン（このMCPサーバーを通じて）：

  • より長いコンテキストウィンドウが必要な場合
  • カスタムシステムプロンプトを使用する場合
  • レート制限を回避する場合
  • 高度な会話管理を行う場合

開発に関する情報

1. コード構造

   • server.py：MCPサーバーのメインプログラム
   • config/：設定ファイルのディレクトリ
   • utils/：ユーティリティ関数のモジュール
   • prompts/：システムプロンプトのテンプレート

2. 貢献ガイド

   • GitHubリポジトリに問題や提案を投稿する
   • 機能ブランチを作成して開発を行う
   • プルリクエストを送信する

トラブルシューティング

一般的な問題

• サーバーを起動できない場合：

  • APIキーが正しく設定されているか確認する
  • すべての依存関係がインストールされていることを確認する
  • エラーログを確認して詳細な情報を取得する

• 会話記録が失われた場合：

  • データベース接続設定を確認する
  • 保存ディレクトリの権限が正しいことを確認する
  • サービスログを確認して記録機能が正常に動作していることを確認する

連絡先

ヘルプが必要な場合やフィードバックを提供したい場合は、GitHubリポジトリのIssuesページにアクセスするか、ディスカッションエリアやトラブルシューティングガイドを参照してください。