Investbrain MCP server

InvestBrain — 投资第二大脑

有经验投资者的纪律自主工具，解决"知行合一"问题

不是投顾，不给建议，而是"镜子" + "纪律锚点"

想法记录 × 投资 RAG × 记忆系统 × 提醒触发 × 行为模式挖掘

5 分钟快速体验

两种使用方式：桌面客户端（推荐） 或 MCP Server。

方式 A：桌面客户端（Windows，推荐）

1. 下载并安装 InvestBrain0.1.2x64_en-US.msi（见 Releases）
2. 打开桌面应用，即见「大脑已加载」状态条与试聊引导
3. 想对话时在设置页填入自己的 LLM Key，即可走真实对话链路

桌面端数据存储在 %APPDATA%\InvestBrain\data，设置页可直接查看数据位置。

方式 B：MCP Server（任意 MCP 客户端）

# 1. 安装 MCP Server 依赖
cd src/mcp_server && pip install -r requirements.txt

# 2. 配置你自己的 LLM API Key（见下文「你的 Key，自己填」）
cp .env.example .env
# 编辑 .env，把 DEEPSEEK_API_KEY 填成你从 DEEPSEEK 后台拿到的 key

# 3. 启动 MCP Server
python server.py

首次启动提示：向量库（Chroma + ONNX Embedding）首次会下载约 80MB 模型文件。若希望跳过向量库、纯工具调用体验，可保持 server.py 中相关注释不变；如需完整 RAG 体验，下载后取消 server.py 内的注释行。

启动后 Server 会以 stdio 方式接受 MCP 客户端调用。配置 Claude Desktop 见下方 Claude Desktop 接入。

你的 Key，自己填

重要：本仓库不预置任何用户的 API key。data/config/llm.json 中 api_key 默认为 null（不是真的 key 占位）；.env.example 只是模板；webhook.json 是空 schema。

你需要从下面这些官方后台自己申请 / rotate：

4 个 key 都写在哪里（都不会进 git）

• MCP 启动必须：DEEPSEEKAPIKEY 环境变量（推荐 User 级系统环境变量，或 CLAUDE.md / .env）
• 可选：TUSHARETOKEN / DASHSCOPEAPIKEY / AGAINSTAPI_KEY（环境变量）
• 飞书 webhook：data/config/webhook.json 里的 feishu 字段（已被 .gitignore 保护）

安全规则

• 你的 key 是你的——不要 share、不要 commit、不要发到任何对话里
• key 进 git 历史（如被 commit 过的老版本）即使后来 rotate 仍可能被人滥用 → 发现泄露立即去对应平台 rotate
• 仓库已有 .gitignore 保护 data/config/.json（含 llm/webhook 配置）+ data/memory/.db（用户记忆库，按 CLAUDE.md 决策"用户数据本地存储，不上传云端"），不要 ! 取消忽略

备注：仓库历史曾 commit 过密钥占位（commit 22e6c72），如已 push 远端，老 key 在 clone 历史里仍可被读——清历史成本高、通常接受 + rotate 即可

快速开始：推送配置

从零到收到第一条微信推送，约 3 分钟。无需阅读任何文档。

方式一：一键脚本（推荐，Windows）

在仓库根目录打开 PowerShell，运行：

powershell -ExecutionPolicy Bypass -File scripts/configure_pushplus.ps1

脚本会交互式引导你完成全部步骤：显示 PushPlus 获取 token 的操作步骤 → 粘贴 token（自动校验格式）→ 写入 data/config/webhook.json 并启用 pushplus 渠道 → 自动调用 send_notification 发送测试消息 → 打印成功/失败原因。

方式二：对话内配置（MCP 客户端内）

直接在任意 MCP 客户端中让 AI 帮你配置：

1. 查看当前配置状态：notify_get_notifier_config()
2. 配置 PushPlus 并发送测试：notify_configure_notifier(channel="pushplus", token="你的token", enabled=true, send_test=true)

PushPlus token 获取步骤

1. 微信扫码关注公众号：https://www.pushplus.plus
2. 进入「个人中心」→ 复制页面上的 token
3. 填入上述任一方式

验证成功：收到测试消息，或 notifygetnotifierconfig() 返回 "enabledchannels": ["pushplus"]。未配置渠道时，提醒触发路径（pricechecker / scheduler）返回中会携带 setupguide 引导信息，而不会静默失败。

安全说明：data/config/webhook.json 已被 .gitignore 保护，token 不会进入 git；请勿把 token 发到任何对话或提交到仓库。

它解决什么问题

核心问题：投资者被叙事带着走，操作没纪律，事后后悔。

Shortened. The full README is on GitHub.