Securo AI Agent教程：自托管LLM+MCP工具调用，用一句话查询你的财务数据

Securo AI Agent教程自托管LLMMCP工具调用用一句话查询你的财务数据【免费下载链接】securoOpen-source personal finance manager. Self-hosted, privacy-first.项目地址: https://gitcode.com/gh_mirrors/se/securoSecuro是一款开源、自托管、隐私优先的个人财务管理系统Personal Finance Manager。它的最大亮点之一是内置的AI Agent 功能接入你自己的 LLM如 Ollama 本地模型、OpenAI、Anthropic通过MCPModel Context Protocol模型上下文协议工具调用让 AI 真正读懂你的账本——一句我上个月花了多少钱Agent 就会自动调用报表工具、查询数据库用自然语言给你完整答案。1️⃣ Securo AI Agent 是什么传统记账软件只能看数据而 Securo 的 AI Agent 能查数据自托管 LLM模型可以完全跑在你自己的服务器/电脑上Ollama数据不出门隐私拉满也支持 OpenAI、Anthropic 等云端模型。MCP 工具调用内置一个独立的 MCP Server 容器暴露30 个财务工具查询净资产、收支报表、交易搜索、预算对比、规则管理等。Agent 运行时由 LLM 自主决定调用哪个工具、传什么参数。提案模式Proposal Mode涉及修改数据的操作如建预算、改分类AI 不会直接动手而是生成一条提案你在界面上确认后才会真正写入数据库。知识库 RAG支持上传文件到个人知识库Agent 可结合你的资料回答问题。核心源码结构如下感兴趣可以深入阅读AI Agent 后端backend/app/agents/MCP 服务器入口mcp_server/main.pyMCP 工具注册表mcp_server/registry.py前端聊天面板chat-panel.tsx2️⃣ 一键开启 AI Agent完整部署步骤AI Agent 是可选功能默认关闭老用户零成本、零影响。开启只需三步步骤 1准备你的 LLM最简单的全本地方案是 Ollama在你的服务器或本地机器上拉一个对话模型即可ollama pull llama3.1如果不想本地跑模型也可以直接用 OpenAI / Anthropic 的 API Key配置方式见下节。步骤 2修改 .env 配置在仓库根目录的.env中设置配置项定义见 backend/app/agents/config.py配置项示例值说明AGENTS_ENABLEDtrue⭐ 总开关必须打开AGENTS_DEFAULT_PROVIDERollamaLLM 提供方AGENTS_OLLAMA_BASE_URLhttp://ollama:11434Ollama 地址连宿主机可用http://host.docker.internal:11434AGENTS_DEFAULT_MODELllama3.1要使用的模型名AGENTS_OPENAI_API_KEYsk-...使用 OpenAI 时填写完整环境变量说明都在 docker-compose.yml 中有中文注释直接照抄即可。步骤 3带上 agents 配置档启动docker compose --profile agents up--profile agents会额外启动mcp-server容器默认监听 8765 端口见 docker-compose.yml这是整个 AI 功能的地基。启动完成后打开 Web 界面侧边栏就会出现 AI 聊天面板。3️⃣ 四种 LLM 提供方本地零成本 vs 云端高性能Securo 内置四种 LLM Provider注册表见 providers/registry.pyProvider适用场景关键配置ollama⭐推荐全本地、零 API 费用、隐私最强AGENTS_OLLAMA_BASE_URLopenai效果最好的云端模型AGENTS_OPENAI_API_KEYanthropicClaude 系列模型AGENTS_ANTHROPIC_API_KEYopenai_compatibleLM Studio、vLLM 等兼容接口AGENTS_OPENAI_COMPAT_BASE_URL..._API_KEY小贴士Docker 已通过host.docker.internal打通宿主机网络Linux 下自动配置所以你可以放心地把 Ollama / LM Studio 跑在宿主机上容器内直接访问。创建 Agent 时/agents页面 → 新建 Agent可以为每个 Agent 单独指定 Provider、模型、系统提示词和工具权限一个工作区可以并存多个财务顾问。4️⃣ 内置 MCP 工具全景30 个工具随便 Agent 调所有内置工具位于 backend/mcp_server/tools/按职能分为四大类 只读查询类问就答无风险get_net_worth— 净资产趋势我的净资产在涨吗get_income_expenses— 收支对比报表最近6个月入不敷出吗get_cash_flow— 现金流预测下个月账上还有多少钱get_dashboard_snapshot— 月度快照总收入/支出/结余/Top 分类一次调用全拿到list_transactions/search_all— 交易明细与全局搜索list_accounts/list_budgets/list_assets/list_goals/list_recurring_transactions— 账户、预算、资产、目标、周期交易get_budget_vs_actual— 预算执行分析这个月哪类预算超支了报表工具的参数设计得非常AI 友好例如 reports.py 中的get_net_worth直接写明描述Use to answer how is my net worth trending?让 LLM 一看就知道何时该用它。✍️ 提案类propose_*需你确认才生效propose_categorize— 给交易重新分类propose_create_transaction— 记账propose_create_budget/propose_create_goal— 建预算、建理财目标propose_create_rule/propose_update_rule/propose_delete_rule— 规则引擎管理 知识库search_knowledge_base— 在你的上传文件中做向量检索RAG️ 安全机制MCP 端点对每一次调用都强制 JWT 鉴权见 auth.py且工具自动限定在令牌所属的 Workspace 内多租户数据互不可见。5️⃣ 提案模式AI 记账但方向盘在你手里这是 Securo AI Agent 最值得称赞的设计 ⭐你对 Agent 说帮我给餐饮支出建一个月 800 元的预算。LLM 调用propose_create_budget工具——工具只生成预览不写数据库is_proposal: true定义在 registry.py。聊天面板里弹出一张提案卡片proposal-card.tsx展示将创建的预算详情。你点确认才真正入库点拒绝AI 会收到反馈继续调整。所有查询类工具只读、随时可跑所有写操作都走提案AI 永远无法绕过你的确认直接改账本。放心把财务助理这个头衔交给它。6️⃣ 反向接入让 Claude Desktop / n8n 调用你的 SecuroSecuro 的 MCP Server 不仅服务自家 Agent还能对外输出。在/agents→ 连接管理 → External MCP access 面板mcp-external-panel.tsx里一键生成长期访问令牌默认 90 天有效配置项AGENTS_MCP_EXTERNAL_TTL_DAYS把令牌填进 Claude Desktop 的 MCP 配置就能在 Claude 里直接问你的财务数据也可以接到 n8n 等自动化平台做每月 1 号自动拉取收支报表并发邮件这类工作流外部端点默认绑定127.0.0.1:8765如需暴露到内网修改AGENTS_MCP_EXTERNAL_HOST_PORT即可详见 docker-compose.yml 注释。7️⃣ 多语言 常见问题Securo 的界面与 Agent 问答均支持多语言包括日语等国际化体验❓ 常见问题Q1不开 AI Agent 会影响其他功能吗不会。AGENTS_ENABLEDfalse默认值时路由不挂载、MCP 不启动、后台任务不运行完全零开销。Q2本地模型效果一般怎么办建议至少使用 8B 以上参数的指令模型或切换到 OpenAI/Anthropic。知识库向量嵌入默认使用内置的 fastembed 多语言小模型零配置也可通过AGENTS_EMBEDDING_PROVIDER切换到 Ollama/OpenAI。Q3数据安全吗所有 LLM 流量由你自己的.env决定走向用 Ollama 则数据 100% 留在本地用云端 API 仅将必要的上下文发往对应服务商。MCP 令牌可随时吊销且与主应用密钥独立。Q4能给 Agent 限定权限吗可以。每个 Agent 支持逐工具开关tools-section.tsx比如只留只读工具、关掉所有propose_*工具打造只读财务分析师。总结Securo 的 AI Agent 把自托管 LLM MCP 工具调用 提案式安全写操作三者结合让个人财务数据第一次真正做到了开口即查。三步部署配.env→ 起 Ollama →docker compose --profile agents up你就能拥有 24 小时在线、数据不出门的私人财务分析师。【免费下载链接】securoOpen-source personal finance manager. Self-hosted, privacy-first.项目地址: https://gitcode.com/gh_mirrors/se/securo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考