═══════════════════════════════════════════════════════════
  超级今日热点 MCP 服务器 - Claude Desktop 配置说明
═══════════════════════════════════════════════════════════

📋 第一步：安装依赖
──────────────────────────────────────────────────────────

方式一：使用安装脚本（推荐）
  MacOS/Linux: 在终端运行
    cd "/Users/dengpengfei/Desktop/超级今日热点"
    ./install.sh
  
  Windows: 双击运行
    install.bat

方式二：手动安装
  1. 打开终端/命令提示符
  2. 进入项目目录
  3. 运行: pip install -r requirements.txt


📋 第二步：配置 Claude Desktop
──────────────────────────────────────────────────────────

1. 找到配置文件位置：

   MacOS:
   ~/Library/Application Support/Claude/claude_desktop_config.json
   
   快速打开命令：
   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Windows:
   %APPDATA%\Claude\claude_desktop_config.json
   
   快速打开命令：
   notepad %APPDATA%\Claude\claude_desktop_config.json


2. 编辑配置文件，添加以下内容：

{
  "mcpServers": {
    "hot-news": {
      "command": "python",
      "args": [
        "/Users/dengpengfei/Desktop/超级今日热点/server.py"
      ]
    }
  }
}

⚠️ 重要提示：
  - 如果配置文件中已有其他内容，只需添加 "hot-news" 部分
  - 路径必须是完整的绝对路径
  - Windows用户请将路径中的 / 改为 \
  - 确保路径中的中文字符正确显示


3. 如果使用虚拟环境，请修改 command 路径：

   MacOS/Linux:
   "command": "/Users/dengpengfei/Desktop/超级今日热点/.venv/bin/python"
   
   Windows:
   "command": "C:\\Users\\YourName\\Desktop\\超级今日热点\\.venv\\Scripts\\python.exe"


📋 第三步：重启 Claude Desktop
──────────────────────────────────────────────────────────

1. 完全退出 Claude Desktop（不是最小化）
2. 重新打开 Claude Desktop
3. 等待几秒让服务器连接


📋 第四步：验证安装
──────────────────────────────────────────────────────────

在 Claude Desktop 中发送以下消息测试：

  "获取微博热搜前5条"

如果返回了热搜数据，说明配置成功！


═══════════════════════════════════════════════════════════
  常见问题解决
═══════════════════════════════════════════════════════════

❌ 问题1：Claude Desktop 显示服务器连接失败

解决方案：
  1. 检查 Python 是否安装: python --version
  2. 检查配置文件路径是否正确
  3. 检查依赖是否安装: pip list | grep mcp
  4. 查看 Claude Desktop 的错误日志


❌ 问题2：找不到配置文件

解决方案：
  1. 手动创建配置文件
  2. 确保文件名是 claude_desktop_config.json
  3. 确保文件在正确的目录下


❌ 问题3：路径包含中文导致问题

解决方案：
  1. 使用完整的绝对路径
  2. 确保路径用引号包围
  3. 如果还有问题，考虑将项目移到英文路径


❌ 问题4：Python 版本过低

解决方案：
  需要 Python 3.10 或更高版本
  
  MacOS 升级:
    brew install python@3.10
  
  Windows 升级:
    从 python.org 下载最新版本


═══════════════════════════════════════════════════════════
  使用示例
═══════════════════════════════════════════════════════════

配置成功后，你可以在 Claude Desktop 中这样使用：

📱 基础查询：
  • 获取微博热搜
  • 获取知乎热榜
  • 获取所有平台的热点
  • 获取B站热门视频

🔍 搜索功能：
  • 搜索包含"科技"的热点
  • 在微博和知乎上搜索"AI"

📊 分析功能：
  • 对比不同平台的热点
  • 分析今天的热点趋势
  • 生成热点新闻摘要


═══════════════════════════════════════════════════════════
  支持的平台
═══════════════════════════════════════════════════════════

✅ 微博热搜 - 实时热搜榜单
✅ 知乎热榜 - 热门问答内容
✅ 百度热搜 - 百度实时热点
✅ 抖音热点 - 热门话题标签
✅ B站热门 - 热门视频排行
✅ 今日头条 - 头条热点新闻


═══════════════════════════════════════════════════════════
  更多帮助
═══════════════════════════════════════════════════════════

📖 详细文档：
  • README.md - 项目说明
  • QUICKSTART.md - 快速开始
  • USAGE.md - 使用指南
  • EXAMPLES.md - 使用示例

🧪 测试脚本：
  python test_server.py

💬 技术支持：
  查看项目文档或提交 Issue


═══════════════════════════════════════════════════════════
  祝你使用愉快！🎉
═══════════════════════════════════════════════════════════

