MCP 経由の Claude デスクトップ API 統合

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

特徴

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

Related MCP server: Code Analysis MCP Server

いつ使うか

プロフェッショナルプラン（デフォルト）:
- クロードデスクトップでの定期的な会話
- プラン制限内での基本的な使用
- 特別な設定は必要ありません
API トークン(この MCP サーバー経由):
- より長いコンテキストウィンドウが必要な場合
- カスタムシステムプロンプトを使用するには
- レート制限を回避するには
- 高度な会話管理

セットアップ手順

リポジトリのクローンを作成する
# 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
依存関係をインストールする
pip install -r requirements.txt
環境を構成する
# Copy environment template cp .env.example .env # Edit .env and add your API key ANTHROPIC_API_KEY=your_api_key_here
Claudeデスクトップの設定
- macOS: ~/Library/Application Support/Claude/に移動します。
  # Using Finder: # 1. Press Cmd + Shift + G # 2. Enter: ~/Library/Application Support/Claude/
- Windows: %APPDATA%\Claude\に移動します。
- claude_desktop_config.jsonを作成または編集する
- config/claude_desktop_config.jsonから内容をコピーします。
- パスとAPIキーを更新する

使用ガイド

基本的な使い方

通常のクロードデスクトップの使用
- クロードと普通にチャットする
- プロフェッショナルプランを使用する
- 特別なコマンドは必要ありません
APIの使用
@claude-api Please answer using the API: What is the capital of France?

高度な機能

システムプロンプトの使用
@claude-api {"system_prompt": "You are an expert fitness coach"} Create a workout plan
会話の管理
# 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クレジットが使用され、料金が発生する場合があります
通常の問い合わせにはプロフェッショナルプランをご利用ください
特に必要な場合にのみ @claude-api を使用してください。
- より長いコンテキストウィンドウ
- カスタムシステムプロンプト
- レート制限を回避するには

利用可能なMCPツール

query_claude
- Claudeへの直接API呼び出し
- システムプロンプトのサポート
- 会話の追跡
clear_conversation
- 会話履歴をリセット
- 複数の会話スレッドを管理する
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)}"

トラブルシューティング

APIキーの問題
- .env で API キーを確認する
- Claude Desktopの設定パスを確認する
- APIキーに正しい権限があることを確認する
接続の問題
- MCPサーバーが実行中かどうかを確認する
- Python環境を確認する
- Claude Desktopのログを確認する
使用上の問題
- @claude-api 構文が正しいことを確認する
- 会話IDを確認する
- システムプロンプトの形式を確認する