74 v0.27.1 更新于 2026-11-04
Actual Budget MCP Server MCP Server
通过 AI 助手管理 Actual Budget 的账户、交易、预算、规则和报告。
适用客户端
本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端
安装配置
本地运行(npm)
{
"mcpServers": {
"actual-mcp-server": {
"command": "npx",
"args": [
"-y",
"actual-mcp-server"
]
}
}
} 本地运行(docker)
{
"mcpServers": {
"actual-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/agigante80/actual-mcp-server:0.27.1"
]
}
}
}将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。
提供的工具 接入后 Agent 可调用这 12 个工具
actual_get_context
获取上下文与基础信息,用于定位当前预算环境。
actual_query_run
运行只读 SELECT 查询以检索预算数据。
actual_transactions_update_batch
批量更新交易记录。
actual_budget_updates_batch
批量更新预算金额。
actual_rules_create_batch
批量创建规则。
actual_transactions_create
创建新交易。
actual_transactions_update
更新单笔交易。
actual_transactions_delete
删除交易。
actual_rules_create
创建单条规则。
actual_budgets_transfer
在预算分类之间转账金额。
actual_budgets_setAmount
设置某预算分类的金额。
actual_budgets_getMonth
获取某个月的预算数据。