Claude Desktop API Integration via MCP

MCP による Claude Desktop API 統合

このプロジェクトでは、Claude Desktop と Claude API のシームレスな統合を可能にする MCP サーバー実装を提供します。Professional Plan の制限を回避し、カスタムシステムプロンプトや会話管理などの高度な機能を利用できます。

機能

• MCP 経由での Claude API との直接統合
• 会話履歴の追跡と管理
• システムプロンプトのサポート
• Professional Plan と API の利用をシームレスに切り替え
• Claude Desktop で簡単に設定

使用する場面

• Professional Plan（デフォルト）：

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

• API Token（この MCP サーバー経由）：

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

セットアップ手順

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

   # Using VS Code:
   # 1. Press Cmd + Shift + P
   # 2. Type "Git: Clone"
   # 3. Paste: https://github.com/mlobo2012/Claude_Desktop_API_USE_VIA_MCP.git
   
   # Or using terminal:
   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. 環境を設定

   # Copy environment template
   cp .env.example .env
   
   # Edit .env and add your API key
   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 と通常どおりチャットします
   • Professional Plan が使用されます
   • 特別なコマンドは不要です

2. API の利用

   @claude-api Please answer using the API: What is the capital of France?
   

高度な機能

1. システムプロンプトの使用

   @claude-api {"system_prompt": "You are an expert fitness coach"} Create a workout plan
   

2. 会話の管理

   # Start a new conversation
   @claude-api {"conversation_id": "project1"} Let's discuss Python
   
   # Continue same conversation
   @claude-api {"conversation_id": "project1"} Tell me more
   
   # View conversation history
   @claude-api get_conversation_history project1
   
   # Clear conversation
   @claude-api clear_conversation project1
   

コスト管理

• API 呼び出しでは Anthropic API クレジットが使用され、料金が発生する場合があります
• 通常の問い合わせには Professional Plan を使用してください
• 次の用途が特に必要な場合に限り、@claude-api を使用してください：
  • より長いコンテキストウィンドウ
  • カスタムシステムプロンプト
  • レート制限の回避

利用可能な MCP ツール

1. query_claude

   • Claude に直接 API 呼び出しを行います
   • システムプロンプトをサポートします
   • 会話を追跡します

2. clear_conversation

   • 会話履歴をリセットします
   • 複数の会話スレッドを管理します

3. get_conversation_history

   • 会話の記録を取得します
   • 会話の流れをデバッグします

開発

メインのサーバー実装は src/claude_api_server.py にあります。機能を拡張するには、@mcp.tool() デコレーターを使用して新しいツールを追加できます。

新しいツールを追加する例：

@mcp.tool()
async def custom_tool(param: str) -> str:
    """
    Custom tool description
    
    Args:
        param: Parameter description
    """
    try:
        # Tool implementation
        return result
    except Exception as e:
        return f"Error: {str(e)}"

トラブルシューティング

1. API キーの問題

   • .env の API キーを確認します
   • Claude Desktop の設定パスを確認します
   • API キーに適切な権限があることを確認します

2. 接続の問題

   • MCP サーバーが実行中か確認します
   • Python 環境を確認します
   • Claude Desktop のログを確認します

3. 使用上の問題

   • @claude-api の構文が正しいことを確認します
   • 会話 ID を確認します
   • システムプロンプトの形式を確認します

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. プルリクエストを送信します

ライセンス

MIT

サポート

問題や質問がある場合：

1. リポジトリで Issue を作成します
2. 既存のディスカッションを確認します
3. トラブルシューティングガイドを確認します