Thoughtful Claude

🚀 深思Claude - DeepSeek R1推理服務器

深思Claude - DeepSeek R1推理服務器是一個增強Claude推理能力的MCP服務器，它通過整合DeepSeek R1先進的推理引擎，讓Claude能夠訪問基於大規模強化學習開發的DeepSeek先進推理模型，有效解決複雜推理問題，提升推理效率和質量。

✨ 主要特性

• 高級推理集成：藉助DeepSeek R1的推理引擎，與Claude的思考過程實現平滑結合，能夠出色地處理複雜的多步驟推理任務。
• 企業級安全：支持使用環境變量（.env文件），安全處理API密鑰，確保在響應中不暴露任何密鑰信息。
• MCP協議支持：實現了全面的MCP服務器功能，可處理流式響應，並進行正確的錯誤管理。
• 現代Python架構：運用async/await進行高效處理，具備正確的異常處理機制和乾淨的代碼組織。

📦 安裝指南

先決條件

• Python 3.12+
• uv包管理器
• DeepSeek API密鑰（可從platform.deepseek.com獲取）

快速開始

# 克隆倉庫
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界面中的🔨工具圖標來驗證安裝是否成功。

🚀 快速開始

啟動服務器

服務器在使用Claude Desktop正確配置時會自動啟動。

基本工作流程

• Claude收到需要推理的查詢。
• 查詢發送到DeepSeek R1進行高級推理。
• 推理以<ant_thinking>標籤包裝返回給Claude。
• Claude將推理整合到其響應中。

示例查詢

• 數學比較：“9.9是否大於9.11？”
• 邏輯謎題：“如果所有A都是B，且一些B是C，則我們可以得出什麼結論？”
• 複雜分析：“比較和對比量子計算與經典計算”

🔧 技術細節

推理管道

1. 查詢處理：接受上下文和問題的結構化格式，並結合輸入以進行綜合推理。
2. DeepSeek R1集成：
   • 模型：deepseek-reasoner
   • 流式：啟用即時處理
   • 最大令牌數：1（優化用於推理提取）
   • 輸出：結構化的推理內容

錯誤處理

• API錯誤：在<ant_thinking>標籤中優雅地包裝錯誤，提供清晰的錯誤消息用於調試，並進行正確的異常傳播。
• 連接問題：設置超時處理（默認30秒），自動清理流，並進行資源管理。