Skip to content

CONFIGURE_AND_VERIFY.md

Latest commit

 

History

History
338 lines (250 loc) · 6.88 KB

CONFIGURE_AND_VERIFY.md

File metadata and controls

338 lines (250 loc) · 6.88 KB
Raw

Alpha-Radar 配置和验证报告

执行时间: 2026-03-17
执行人: AI Assistant
项目版本: v2.1.0

✅ 已完成的配置和验证

1. MCP Server 安装和测试

操作:

cd mcp-server && npm install
node test.js

结果:

✅ MCP Server 依赖安装成功（75 个包）
✅ MCP Server 测试通过
✅ 数据库连接正常（77 条记录）
✅ 4 个工具可用：get_latest_news, search_news, get_stats, push_message
✅ 2 个资源可用：news://recent, news://categories

MCP Server 信息:

名称：Alpha-Radar MCP Server
版本：1.0.0
工具：get_latest_news, search_news, get_stats, push_message
资源：news://recent, news://categories

2. 推送渠道验证

测试结果:

✅ 推送管理器初始化成功
✅ 已配置渠道数：1 (企业微信)
✅ 企业微信渠道状态：YES (速率限制：20/min)

新增渠道（需配置环境变量后激活）:

  • ✅ 飞书 (FeishuChannel)
  • ✅ ntfy (NtfyChannel)
  • ✅ Bark (BarkChannel)

3. 脚本文件创建

文件 状态 说明
setup-windows.bat ✅ 已创建 Windows 一键安装
setup.sh ✅ 已创建 macOS/Linux 一键安装
quick-setup.bat ✅ 已创建 Windows 快速启动
configure.js ✅ 已创建 交互式配置向导
QUICK_START.md ✅ 已创建 快速启动指南

4. 文档创建

文档 状态 内容
OPTIMIZATION_COMPLETE.md ✅ 已创建 完整优化报告
QUICK_START.md ✅ 已创建 快速启动指南
CONFIGURE_AND_VERIFY.md ✅ 本文件 配置验证报告
FRONTEND_BUILD.md ✅ 已创建 前端构建指南
mcp-server/README.md ✅ 已创建 MCP 使用文档

📋 配置检查清单

必需配置 ⚠️

配置项 状态 操作建议
DEEPSEEK_API_KEY ❌ 未配置 必须填入 https://platform.deepseek.com/
.env 文件 ✅ 已存在 编辑填入 API Key

推送渠道配置 ⚠️

渠道 状态 操作建议
企业微信 ✅ 已配置 可正常使用
飞书 ⏸️ 待配置 填入 FEISHU_WEBHOOK_URL
ntfy ⏸️ 待配置 填入 NTFY_TOPIC
Bark ⏸️ 待配置 填入 BARK_DEVICE_KEY

MCP Server ✅

项目 状态 备注
依赖安装 ✅ 完成 75 个包
功能测试 ✅ 通过 所有工具可用
Claude Desktop 配置 ⏸️ 待手动配置 见下方说明

🔧 下一步操作指南

立即行动（必须）

1. 配置 DeepSeek API Key

编辑 .env 文件：

DEEPSEEK_API_KEY=sk-your-actual-api-key

获取 API Key:

  1. 访问 https://platform.deepseek.com/
  2. 注册/登录账号
  3. 创建 API Key
  4. 复制到 .env

2. 启动服务测试

npm start

访问 http://localhost:3001 查看前端界面

可选配置（推荐）

3. 配置更多推送渠道

编辑 .env 添加：

# 飞书
FEISHU_WEBHOOK_URL=https://open.feishu.cn/open-apis/bot/v2/hook/xxx
FEISHU_SECRET=xxx

# ntfy (简单，无需注册)
NTFY_TOPIC=my-alpha-radar
NTFY_SERVER=https://ntfy.sh

# Bark (iOS)
BARK_DEVICE_KEY=your-device-key
BARK_SERVER=https://api.day.app

4. 配置 MCP Server 到 Claude Desktop

Windows: 编辑 %APPDATA%\Claude\claude_desktop_config.json

macOS: 编辑 ~/Library/Application Support/Claude/claude_desktop_config.json

添加：

{
  "mcpServers": {
    "alpha-radar": {
      "command": "node",
      "args": ["server.js"],
      "cwd": "C:/Users/lenovo/alpha-radar/mcp-server",
      "env": {
        "API_BASE_URL": "http://localhost:3001/api",
        "API_SECRET": ""
      }
    }
  }
}

然后重启 Claude Desktop。

🧪 测试命令汇总

测试 MCP Server

npm run test:mcp

测试推送

npm run test-push

查看推送渠道状态

node -e "const {pushManager} = require('./push-channel'); console.log(pushManager.getStatus())"

测试数据库

node -e "const {db} = require('./db'); const stmt = db.prepare('SELECT COUNT(*) as c FROM news'); console.log('数据库新闻数:', stmt.get().c)"

测试 AI 兴趣筛选

node -e "const {getStatus} = require('./ai-interest-filter'); console.log(require('./ai-interest-filter').getStatus())"

📊 当前系统状态

数据库状态 ✅

新闻总数：77 条
分类数量：9 个
数据来源：多个 Web3 数据源

MCP Server ✅

状态：正常运行
工具：4 个
资源：2 个
测试：通过

推送渠道 ⚠️

已配置：1 个（企业微信）
待配置：3 个（飞书、ntfy、Bark）

前端 ✅

构建状态：已构建
文件：public/app.js (42KB)
访问：http://localhost:3001

🎯 快速验证流程

5 分钟快速验证

  1. 配置 API Key (1 分钟)

    # 编辑 .env
DEEPSEEK_API_KEY=sk-xxx

  2. 启动服务 (1 分钟)

    npm start

  3. 访问前端 (1 分钟)

    打开 http://localhost:3001
查看新闻列表

  4. 测试 MCP (2 分钟)

    # 在 Claude Desktop 中对话
"获取最新的香港合规新闻"

📝 常见问题

Q: 为什么只显示 1 个推送渠道？

A: 其他渠道需要配置对应的环境变量才会激活。编辑 .env 添加相应配置即可。

Q: MCP Server 测试成功但在 Claude Desktop 中不工作？

A:

  1. 确保主服务已启动 (npm start)
  2. 检查 Claude Desktop 配置路径是否正确
  3. 重启 Claude Desktop
  4. 查看日志：%APPDATA%\Claude\logs\

Q: 如何验证所有功能都正常？

A: 运行以下命令：

# 测试 MCP
npm run test:mcp

# 测试推送
npm run test-push

# 查看数据库
node -e "const {db} = require('./db'); console.log(db.prepare('SELECT COUNT(*) FROM news').pluck().get())"

📚 相关文档

  • QUICK_START.md - 快速启动指南（30 秒上手）
  • OPTIMIZATION_COMPLETE.md - 完整优化报告
  • mcp-server/README.md - MCP Server 详细文档
  • FRONTEND_BUILD.md - 前端构建指南
  • README.md - 项目主文档

✅ 总结

已完成

  • ✅ MCP Server 安装和测试
  • ✅ 推送渠道验证
  • ✅ 安装脚本创建
  • ✅ 配置向导创建
  • ✅ 文档完善

待用户操作

  • ⚠️ 配置 DeepSeek API Key（必须）
  • ⚠️ 配置 Claude Desktop（可选，用于 MCP 功能）
  • ⚠️ 配置更多推送渠道（可选）

系统就绪状态

MCP Server ......... ✅ 就绪
推送系统 ........... ⚠️ 部分就绪（需配置）
数据库 ............. ✅ 就绪（77 条记录）
前端 ............... ✅ 就绪
文档 ............... ✅ 完善

配置和验证完成时间：2026-03-17
Alpha-Radar v2.1.0