用，用一句話查詢你的財(cái)務(wù)數(shù)據(jù))
Securo AI Agent教程自托管LLMMCP工具調(diào)用用一句話查詢你的財(cái)務(wù)數(shù)據(jù)【免費(fèi)下載鏈接】securoOpen-source personal finance manager. Self-hosted, privacy-first.項(xiàng)目地址: https://gitcode.com/gh_mirrors/se/securoSecuro是一款開源、自托管、隱私優(yōu)先的個(gè)人財(cái)務(wù)管理系統(tǒng)Personal Finance Manager。它的最大亮點(diǎn)之一是內(nèi)置的AI Agent 功能接入你自己的 LLM如 Ollama 本地模型、OpenAI、Anthropic通過MCPModel Context Protocol模型上下文協(xié)議工具調(diào)用讓 AI 真正讀懂你的賬本——一句我上個(gè)月花了多少錢Agent 就會自動調(diào)用報(bào)表工具、查詢數(shù)據(jù)庫用自然語言給你完整答案。1?? Securo AI Agent 是什么傳統(tǒng)記賬軟件只能看數(shù)據(jù)而 Securo 的 AI Agent 能查數(shù)據(jù)自托管 LLM模型可以完全跑在你自己的服務(wù)器/電腦上Ollama數(shù)據(jù)不出門隱私拉滿也支持 OpenAI、Anthropic 等云端模型。MCP 工具調(diào)用內(nèi)置一個(gè)獨(dú)立的 MCP Server 容器暴露30 個(gè)財(cái)務(wù)工具查詢凈資產(chǎn)、收支報(bào)表、交易搜索、預(yù)算對比、規(guī)則管理等。Agent 運(yùn)行時(shí)由 LLM 自主決定調(diào)用哪個(gè)工具、傳什么參數(shù)。提案模式Proposal Mode涉及修改數(shù)據(jù)的操作如建預(yù)算、改分類AI 不會直接動手而是生成一條提案你在界面上確認(rèn)后才會真正寫入數(shù)據(jù)庫。知識庫 RAG支持上傳文件到個(gè)人知識庫Agent 可結(jié)合你的資料回答問題。核心源碼結(jié)構(gòu)如下感興趣可以深入閱讀AI Agent 后端backend/app/agents/MCP 服務(wù)器入口mcp_server/main.pyMCP 工具注冊表mcp_server/registry.py前端聊天面板chat-panel.tsx2?? 一鍵開啟 AI Agent完整部署步驟AI Agent 是可選功能默認(rèn)關(guān)閉老用戶零成本、零影響。開啟只需三步步驟 1準(zhǔn)備你的 LLM最簡單的全本地方案是 Ollama在你的服務(wù)器或本地機(jī)器上拉一個(gè)對話模型即可ollama pull llama3.1如果不想本地跑模型也可以直接用 OpenAI / Anthropic 的 API Key配置方式見下節(jié)。步驟 2修改 .env 配置在倉庫根目錄的.env中設(shè)置配置項(xiàng)定義見 backend/app/agents/config.py配置項(xiàng)示例值說明AGENTS_ENABLEDtrue? 總開關(guān)必須打開AGENTS_DEFAULT_PROVIDERollamaLLM 提供方AGENTS_OLLAMA_BASE_URLhttp://ollama:11434Ollama 地址連宿主機(jī)可用http://host.docker.internal:11434AGENTS_DEFAULT_MODELllama3.1要使用的模型名AGENTS_OPENAI_API_KEYsk-...使用 OpenAI 時(shí)填寫完整環(huán)境變量說明都在 docker-compose.yml 中有中文注釋直接照抄即可。步驟 3帶上 agents 配置檔啟動docker compose --profile agents up--profile agents會額外啟動mcp-server容器默認(rèn)監(jiān)聽 8765 端口見 docker-compose.yml這是整個(gè) AI 功能的地基。啟動完成后打開 Web 界面?zhèn)冗厵诰蜁霈F(xiàn) AI 聊天面板。3?? 四種 LLM 提供方本地零成本 vs 云端高性能Securo 內(nèi)置四種 LLM Provider注冊表見 providers/registry.pyProvider適用場景關(guān)鍵配置ollama?推薦全本地、零 API 費(fèi)用、隱私最強(qiáng)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打通宿主機(jī)網(wǎng)絡(luò)Linux 下自動配置所以你可以放心地把 Ollama / LM Studio 跑在宿主機(jī)上容器內(nèi)直接訪問。創(chuàng)建 Agent 時(shí)/agents頁面 → 新建 Agent可以為每個(gè) Agent 單獨(dú)指定 Provider、模型、系統(tǒng)提示詞和工具權(quán)限一個(gè)工作區(qū)可以并存多個(gè)財(cái)務(wù)顧問。4?? 內(nèi)置 MCP 工具全景30 個(gè)工具隨便 Agent 調(diào)所有內(nèi)置工具位于 backend/mcp_server/tools/按職能分為四大類 只讀查詢類問就答無風(fēng)險(xiǎn)get_net_worth— 凈資產(chǎn)趨勢我的凈資產(chǎn)在漲嗎get_income_expenses— 收支對比報(bào)表最近6個(gè)月入不敷出嗎get_cash_flow— 現(xiàn)金流預(yù)測下個(gè)月賬上還有多少錢get_dashboard_snapshot— 月度快照總收入/支出/結(jié)余/Top 分類一次調(diào)用全拿到list_transactions/search_all— 交易明細(xì)與全局搜索list_accounts/list_budgets/list_assets/list_goals/list_recurring_transactions— 賬戶、預(yù)算、資產(chǎn)、目標(biāo)、周期交易get_budget_vs_actual— 預(yù)算執(zhí)行分析這個(gè)月哪類預(yù)算超支了報(bào)表工具的參數(shù)設(shè)計(jì)得非常AI 友好例如 reports.py 中的get_net_worth直接寫明描述Use to answer how is my net worth trending?讓 LLM 一看就知道何時(shí)該用它。?? 提案類propose_*需你確認(rèn)才生效propose_categorize— 給交易重新分類propose_create_transaction— 記賬propose_create_budget/propose_create_goal— 建預(yù)算、建理財(cái)目標(biāo)propose_create_rule/propose_update_rule/propose_delete_rule— 規(guī)則引擎管理 知識庫search_knowledge_base— 在你的上傳文件中做向量檢索RAG? 安全機(jī)制MCP 端點(diǎn)對每一次調(diào)用都強(qiáng)制 JWT 鑒權(quán)見 auth.py且工具自動限定在令牌所屬的 Workspace 內(nèi)多租戶數(shù)據(jù)互不可見。5?? 提案模式AI 記賬但方向盤在你手里這是 Securo AI Agent 最值得稱贊的設(shè)計(jì) ?你對 Agent 說幫我給餐飲支出建一個(gè)月 800 元的預(yù)算。LLM 調(diào)用propose_create_budget工具——工具只生成預(yù)覽不寫數(shù)據(jù)庫is_proposal: true定義在 registry.py。聊天面板里彈出一張?zhí)岚缚ㄆ琾roposal-card.tsx展示將創(chuàng)建的預(yù)算詳情。你點(diǎn)確認(rèn)才真正入庫點(diǎn)拒絕AI 會收到反饋繼續(xù)調(diào)整。所有查詢類工具只讀、隨時(shí)可跑所有寫操作都走提案AI 永遠(yuǎn)無法繞過你的確認(rèn)直接改賬本。放心把財(cái)務(wù)助理這個(gè)頭銜交給它。6?? 反向接入讓 Claude Desktop / n8n 調(diào)用你的 SecuroSecuro 的 MCP Server 不僅服務(wù)自家 Agent還能對外輸出。在/agents→ 連接管理 → External MCP access 面板mcp-external-panel.tsx里一鍵生成長期訪問令牌默認(rèn) 90 天有效配置項(xiàng)AGENTS_MCP_EXTERNAL_TTL_DAYS把令牌填進(jìn) Claude Desktop 的 MCP 配置就能在 Claude 里直接問你的財(cái)務(wù)數(shù)據(jù)也可以接到 n8n 等自動化平臺做每月 1 號自動拉取收支報(bào)表并發(fā)郵件這類工作流外部端點(diǎn)默認(rèn)綁定127.0.0.1:8765如需暴露到內(nèi)網(wǎng)修改AGENTS_MCP_EXTERNAL_HOST_PORT即可詳見 docker-compose.yml 注釋。7?? 多語言 常見問題Securo 的界面與 Agent 問答均支持多語言包括日語等國際化體驗(yàn)? 常見問題Q1不開 AI Agent 會影響其他功能嗎不會。AGENTS_ENABLEDfalse默認(rèn)值時(shí)路由不掛載、MCP 不啟動、后臺任務(wù)不運(yùn)行完全零開銷。Q2本地模型效果一般怎么辦建議至少使用 8B 以上參數(shù)的指令模型或切換到 OpenAI/Anthropic。知識庫向量嵌入默認(rèn)使用內(nèi)置的 fastembed 多語言小模型零配置也可通過AGENTS_EMBEDDING_PROVIDER切換到 Ollama/OpenAI。Q3數(shù)據(jù)安全嗎所有 LLM 流量由你自己的.env決定走向用 Ollama 則數(shù)據(jù) 100% 留在本地用云端 API 僅將必要的上下文發(fā)往對應(yīng)服務(wù)商。MCP 令牌可隨時(shí)吊銷且與主應(yīng)用密鑰獨(dú)立。Q4能給 Agent 限定權(quán)限嗎可以。每個(gè) Agent 支持逐工具開關(guān)tools-section.tsx比如只留只讀工具、關(guān)掉所有propose_*工具打造只讀財(cái)務(wù)分析師?？偨Y(jié)Securo 的 AI Agent 把自托管 LLM MCP 工具調(diào)用 提案式安全寫操作三者結(jié)合讓個(gè)人財(cái)務(wù)數(shù)據(jù)第一次真正做到了開口即查。三步部署配.env→ 起 Ollama →docker compose --profile agents up你就能擁有 24 小時(shí)在線、數(shù)據(jù)不出門的私人財(cái)務(wù)分析師?！久赓M(fèi)下載鏈接】securoOpen-source personal finance manager. Self-hosted, privacy-first.項(xiàng)目地址: https://gitcode.com/gh_mirrors/se/securo創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Securo AI Agent教程：自托管LLM+MCP工具調(diào)用，用一句話查詢你的財(cái)務(wù)數(shù)據(jù)
Securo AI Agent教程自托管LLMMCP工具調(diào)用用一句話查詢你的財(cái)務(wù)數(shù)據(jù)【免費(fèi)下載鏈接】securoOpen-source personal finance manager. Self-hosted, privacy-first.項(xiàng)目地址: https://gitcode.com/gh_mirrors/se/securoSecuro是一款開源、自托管、隱私優(yōu)先的個(gè)人財(cái)務(wù)管理系統(tǒng)Personal Finance Manager。它的最大亮點(diǎn)之一是內(nèi)置的AI Agent 功能接入你自己的 LLM如 Ollama 本地模型、OpenAI、Anthropic通過MCPModel Context Protocol模型上下文協(xié)議工具調(diào)用讓 AI 真正讀懂你的賬本——一句我上個(gè)月花了多少錢Agent 就會自動調(diào)用報(bào)表工具、查詢數(shù)據(jù)庫用自然語言給你完整答案。1?? Securo AI Agent 是什么傳統(tǒng)記賬軟件只能看數(shù)據(jù)而 Securo 的 AI Agent 能查數(shù)據(jù)自托管 LLM模型可以完全跑在你自己的服務(wù)器/電腦上Ollama數(shù)據(jù)不出門隱私拉滿也支持 OpenAI、Anthropic 等云端模型。MCP 工具調(diào)用內(nèi)置一個(gè)獨(dú)立的 MCP Server 容器暴露30 個(gè)財(cái)務(wù)工具查詢凈資產(chǎn)、收支報(bào)表、交易搜索、預(yù)算對比、規(guī)則管理等。Agent 運(yùn)行時(shí)由 LLM 自主決定調(diào)用哪個(gè)工具、傳什么參數(shù)。提案模式Proposal Mode涉及修改數(shù)據(jù)的操作如建預(yù)算、改分類AI 不會直接動手而是生成一條提案你在界面上確認(rèn)后才會真正寫入數(shù)據(jù)庫。知識庫 RAG支持上傳文件到個(gè)人知識庫Agent 可結(jié)合你的資料回答問題。核心源碼結(jié)構(gòu)如下感興趣可以深入閱讀AI Agent 后端backend/app/agents/MCP 服務(wù)器入口mcp_server/main.pyMCP 工具注冊表mcp_server/registry.py前端聊天面板chat-panel.tsx2?? 一鍵開啟 AI Agent完整部署步驟AI Agent 是可選功能默認(rèn)關(guān)閉老用戶零成本、零影響。開啟只需三步步驟 1準(zhǔn)備你的 LLM最簡單的全本地方案是 Ollama在你的服務(wù)器或本地機(jī)器上拉一個(gè)對話模型即可ollama pull llama3.1如果不想本地跑模型也可以直接用 OpenAI / Anthropic 的 API Key配置方式見下節(jié)。步驟 2修改 .env 配置在倉庫根目錄的.env中設(shè)置配置項(xiàng)定義見 backend/app/agents/config.py配置項(xiàng)示例值說明AGENTS_ENABLEDtrue? 總開關(guān)必須打開AGENTS_DEFAULT_PROVIDERollamaLLM 提供方AGENTS_OLLAMA_BASE_URLhttp://ollama:11434Ollama 地址連宿主機(jī)可用http://host.docker.internal:11434AGENTS_DEFAULT_MODELllama3.1要使用的模型名AGENTS_OPENAI_API_KEYsk-...使用 OpenAI 時(shí)填寫完整環(huán)境變量說明都在 docker-compose.yml 中有中文注釋直接照抄即可。步驟 3帶上 agents 配置檔啟動docker compose --profile agents up--profile agents會額外啟動mcp-server容器默認(rèn)監(jiān)聽 8765 端口見 docker-compose.yml這是整個(gè) AI 功能的地基。啟動完成后打開 Web 界面?zhèn)冗厵诰蜁霈F(xiàn) AI 聊天面板。3?? 四種 LLM 提供方本地零成本 vs 云端高性能Securo 內(nèi)置四種 LLM Provider注冊表見 providers/registry.pyProvider適用場景關(guān)鍵配置ollama?推薦全本地、零 API 費(fèi)用、隱私最強(qiáng)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打通宿主機(jī)網(wǎng)絡(luò)Linux 下自動配置所以你可以放心地把 Ollama / LM Studio 跑在宿主機(jī)上容器內(nèi)直接訪問。創(chuàng)建 Agent 時(shí)/agents頁面 → 新建 Agent可以為每個(gè) Agent 單獨(dú)指定 Provider、模型、系統(tǒng)提示詞和工具權(quán)限一個(gè)工作區(qū)可以并存多個(gè)財(cái)務(wù)顧問。4?? 內(nèi)置 MCP 工具全景30 個(gè)工具隨便 Agent 調(diào)所有內(nèi)置工具位于 backend/mcp_server/tools/按職能分為四大類 只讀查詢類問就答無風(fēng)險(xiǎn)get_net_worth— 凈資產(chǎn)趨勢我的凈資產(chǎn)在漲嗎get_income_expenses— 收支對比報(bào)表最近6個(gè)月入不敷出嗎get_cash_flow— 現(xiàn)金流預(yù)測下個(gè)月賬上還有多少錢get_dashboard_snapshot— 月度快照總收入/支出/結(jié)余/Top 分類一次調(diào)用全拿到list_transactions/search_all— 交易明細(xì)與全局搜索list_accounts/list_budgets/list_assets/list_goals/list_recurring_transactions— 賬戶、預(yù)算、資產(chǎn)、目標(biāo)、周期交易get_budget_vs_actual— 預(yù)算執(zhí)行分析這個(gè)月哪類預(yù)算超支了報(bào)表工具的參數(shù)設(shè)計(jì)得非常AI 友好例如 reports.py 中的get_net_worth直接寫明描述Use to answer how is my net worth trending?讓 LLM 一看就知道何時(shí)該用它。?? 提案類propose_*需你確認(rèn)才生效propose_categorize— 給交易重新分類propose_create_transaction— 記賬propose_create_budget/propose_create_goal— 建預(yù)算、建理財(cái)目標(biāo)propose_create_rule/propose_update_rule/propose_delete_rule— 規(guī)則引擎管理 知識庫search_knowledge_base— 在你的上傳文件中做向量檢索RAG? 安全機(jī)制MCP 端點(diǎn)對每一次調(diào)用都強(qiáng)制 JWT 鑒權(quán)見 auth.py且工具自動限定在令牌所屬的 Workspace 內(nèi)多租戶數(shù)據(jù)互不可見。5?? 提案模式AI 記賬但方向盤在你手里這是 Securo AI Agent 最值得稱贊的設(shè)計(jì) ?你對 Agent 說幫我給餐飲支出建一個(gè)月 800 元的預(yù)算。LLM 調(diào)用propose_create_budget工具——工具只生成預(yù)覽不寫數(shù)據(jù)庫is_proposal: true定義在 registry.py。聊天面板里彈出一張?zhí)岚缚ㄆ琾roposal-card.tsx展示將創(chuàng)建的預(yù)算詳情。你點(diǎn)確認(rèn)才真正入庫點(diǎn)拒絕AI 會收到反饋繼續(xù)調(diào)整。所有查詢類工具只讀、隨時(shí)可跑所有寫操作都走提案AI 永遠(yuǎn)無法繞過你的確認(rèn)直接改賬本。放心把財(cái)務(wù)助理這個(gè)頭銜交給它。6?? 反向接入讓 Claude Desktop / n8n 調(diào)用你的 SecuroSecuro 的 MCP Server 不僅服務(wù)自家 Agent還能對外輸出。在/agents→ 連接管理 → External MCP access 面板mcp-external-panel.tsx里一鍵生成長期訪問令牌默認(rèn) 90 天有效配置項(xiàng)AGENTS_MCP_EXTERNAL_TTL_DAYS把令牌填進(jìn) Claude Desktop 的 MCP 配置就能在 Claude 里直接問你的財(cái)務(wù)數(shù)據(jù)也可以接到 n8n 等自動化平臺做每月 1 號自動拉取收支報(bào)表并發(fā)郵件這類工作流外部端點(diǎn)默認(rèn)綁定127.0.0.1:8765如需暴露到內(nèi)網(wǎng)修改AGENTS_MCP_EXTERNAL_HOST_PORT即可詳見 docker-compose.yml 注釋。7?? 多語言 常見問題Securo 的界面與 Agent 問答均支持多語言包括日語等國際化體驗(yàn)? 常見問題Q1不開 AI Agent 會影響其他功能嗎不會。AGENTS_ENABLEDfalse默認(rèn)值時(shí)路由不掛載、MCP 不啟動、后臺任務(wù)不運(yùn)行完全零開銷。Q2本地模型效果一般怎么辦建議至少使用 8B 以上參數(shù)的指令模型或切換到 OpenAI/Anthropic。知識庫向量嵌入默認(rèn)使用內(nèi)置的 fastembed 多語言小模型零配置也可通過AGENTS_EMBEDDING_PROVIDER切換到 Ollama/OpenAI。Q3數(shù)據(jù)安全嗎所有 LLM 流量由你自己的.env決定走向用 Ollama 則數(shù)據(jù) 100% 留在本地用云端 API 僅將必要的上下文發(fā)往對應(yīng)服務(wù)商。MCP 令牌可隨時(shí)吊銷且與主應(yīng)用密鑰獨(dú)立。Q4能給 Agent 限定權(quán)限嗎可以。每個(gè) Agent 支持逐工具開關(guān)tools-section.tsx比如只留只讀工具、關(guān)掉所有propose_*工具打造只讀財(cái)務(wù)分析師?？偨Y(jié)Securo 的 AI Agent 把自托管 LLM MCP 工具調(diào)用 提案式安全寫操作三者結(jié)合讓個(gè)人財(cái)務(wù)數(shù)據(jù)第一次真正做到了開口即查。三步部署配.env→ 起 Ollama →docker compose --profile agents up你就能擁有 24 小時(shí)在線、數(shù)據(jù)不出門的私人財(cái)務(wù)分析師?！久赓M(fèi)下載鏈接】securoOpen-source personal finance manager. Self-hosted, privacy-first.項(xiàng)目地址: https://gitcode.com/gh_mirrors/se/securo創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考