🤔 Thoughtful Claude - DeepSeek R1 Reasoning Server

🤔 Thoughtful Claude - DeepSeek R1 Reasoning Server

DeepSeek R1 の高度な推論エンジンを統合することで、Claude の推論能力を強化する MCP サーバーです。大規模な強化学習によって開発された、DeepSeek の最先端の推論モデルを Claude から利用できます。

🌟 特長

• 高度な推論機能の統合

  • DeepSeek R1 の推論エンジンを活用
  • Claude の思考プロセスにシームレスに統合
  • 複雑な複数ステップの推論タスクに対応

• エンタープライズグレードのセキュリティ

  • 環境変数に対応（.env ファイル）
  • API キーを安全に処理
  • レスポンスにキーを公開しない

• MCP プロトコルのサポート

  • MCP サーバーを完全に実装
  • ストリーミングレスポンスの処理
  • 適切なエラー管理

• 最新の Python アーキテクチャ

  • 効率的な処理のための Async/await
  • 適切な例外処理
  • クリーンなコード構成

📦 インストール

1. 前提条件

   • Python 3.12+
   • uv パッケージマネージャー
   • DeepSeek API キー（platform.deepseek.com から取得できます）

2. クイックスタート

# Clone repository
git clone https://github.com/martinbowling/thoughtful-claude.git
cd thoughtful-claude

# Install MCP and dependencies
pip install "mcp[cli]" httpx python-dotenv

# Create .env file with your API key
echo "DEEPSEEK_API_KEY=your_key_here" > .env

# Install the MCP server with environment variables
mcp install server.py -f .env

mcp install コマンドは以下を実行します：

• サーバーを Claude Desktop に登録
• .env から環境変数を設定
• 適切な Python インタープリターで実行するようにサーバーを設定

Claude Desktop のインターフェースに 🔨 ツールアイコンが表示されていることを確認すると、インストールを検証できます。

🚀 使用方法

1. サーバーの起動 適切に設定されていれば、Claude Desktop を使用するとサーバーが自動的に起動します。

2. 基本的なワークフロー

   • Claude が推論を必要とするクエリを受け取ります
   • クエリが高度な推論のために DeepSeek R1 に送信されます
   • 推論結果が <ant_thinking> タグで囲まれて Claude に返されます
   • Claude が推論結果を回答に取り入れます

3. クエリの例

   • 数学的な比較：「9.9 は 9.11 より大きいですか？」
   • 論理パズル：「すべての A が B で、一部の B が C である場合、何が結論できますか？」
   • 複雑な分析：「量子コンピューティングと従来型コンピューティングを比較し、違いを説明してください」

🧠 技術詳細

推論パイプライン

1. クエリ処理

   • コンテキストと質問を構造化された形式で受け付けます
   • 入力を組み合わせて包括的な推論を行います

2. DeepSeek R1 の統合

   • モデル：deepseek-reasoner
   • ストリーム：リアルタイム処理のため有効
   • 最大トークン数：1（推論の抽出に最適化）
   • 出力：構造化された推論コンテンツ

エラー処理

• API エラー

  • <ant_thinking> タグでエラーを適切にラップ
  • デバッグに役立つ明確なエラーメッセージ
  • 適切な例外伝播

• 接続の問題

  • タイムアウト処理（デフォルトは 30 秒）
  • ストリームを自動的にクリーンアップ
  • リソース管理

🛠 トラブルシューティング

よくある問題

# Server not found in Claude Desktop
ERROR: MCP server not detected

# Solution
Check claude_desktop_config.json path and format

パフォーマンスのヒント

• クエリは焦点を絞り、具体的にします
• 関連するコンテキストがある場合は提示します
• 複雑なクエリには構造化された入力形式を使用します

📄 ライセンス

MIT License - 詳細は LICENSE を参照してください

🙏 謝辞

• DeepSeek R1 - 推論能力における画期的な取り組みに感謝します
• Claude - 高度な AI アシスタントプラットフォームに感謝します
• MCP Protocol - AI ツールのシームレスな統合を実現するプロトコルに感謝します