Thoughtful Claude

🚀 深思Claude - DeepSeek R1推理サーバ

このサーバは、DeepSeek R1の高度な推論エンジンを統合することで、Claudeの推論能力を強化するMCPサーバです。Claudeには、大規模な強化学習によって開発されたDeepSeekの最先端の推論モデルへのアクセス機能が提供されます。

✨ 主な機能

• 高度な推論統合

  • DeepSeek R1の推論エンジンを活用
  • Claudeの思考プロセスとスムーズに統合
  • 複雑な多段階推論タスクを処理

• 企業レベルのセキュリティ

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

• MCPプロトコルサポート

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

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

  • async/awaitを使用した効率的な処理
  • 適切な例外処理
  • きれいなコード構成

📦 インストール

1. 前提条件

   • Python 3.12以上
   • uvパッケージマネージャ
   • DeepSeek APIキー（platform.deepseek.comから取得）

2. クイックスタート

# リポジトリをクローン
git clone https://github.com/martinbowling/thoughtful-claude.git
cd thoughtful-claude

# MCPと依存関係をインストール
pip install "mcp[cli]" httpx python-dotenv

# APIキーを含む.envファイルを作成
echo "DEEPSEEK_API_KEY=your_key_here" > .env

# 環境変数を使用してMCPサーバをインストール
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秒）
  • ストリームを自動的にクリーンアップ
  • リソース管理