actual-mcp-server

概述

Actual MCP Server是一个全面的Model Context Protocol实现，将AI助手与Actual Budget连接。它提供HTTP和stdio两种传输方式，适用于不同的部署场景。服务器提供63个工具，覆盖84%的Actual Budget API，包括独特的ActualQL驱动的搜索工具。它支持多预算切换，具有生产级的可靠性和连接池功能，并通过OIDC认证实现安全的多用户支持。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• actual_accounts_list

  List all accounts

  试试:Show me all my accounts试试:List all accounts in my budget
• actual_accounts_create

  Create new account

  试试:Create a new savings account试试:Add a new investment account named 'Brokerage'
• actual_accounts_update

  Update account details

  试试:Change my checking account name to 'Main Checking'试试:Update my savings account balance
• actual_transactions_get

  Get transactions for an account

  试试:Show me all transactions from my checking account试试:Get recent transactions for my Visa card
• actual_transactions_create

  Create new transaction(s)

  试试:Add a $50 grocery transaction to my checking account试试:Create a $1000 rent payment transaction
• actual_transactions_filter

  Filter with advanced criteria

  试试:Find all transactions over $100 in the last month试试:Show me all dining transactions in March
• actual_transactions_search_by_category

  Search by category name

  试试:Find all transactions in the 'Groceries' category试试:Show me all dining expenses
• actual_transactions_search_by_payee

  Find by payee/vendor

  试试:Find transactions from 'Amazon'试试:Show me all payments to 'Netflix'
• actual_transactions_summary_by_category

  Spending summary grouped by category

  试试:Show me my spending by category for this month试试:Get a category summary for last month
• actual_transactions_search_by_month

  Search by month using $month transform

  试试:Show me all transactions from last month试试:Get transactions from February 2023
• actual_transactions_search_by_amount

  Find by amount range

  试试:Find all transactions between $50 and $100试试:Show me transactions over $500
• actual_budgets_switch

  Switch between different budget files

  试试:Switch to my 'Vacation 2023' budget试试:Change to the household budget

可对比工具

安装

docker run -d \
  --name actual-mcp-server-backend \
  -p 3600:3600 \
  -e ACTUAL_SERVER_URL=http://localhost:5006 \
  -e ACTUAL_PASSWORD=your_password \
  -e ACTUAL_BUDGET_SYNC_ID=your_sync_id \
  -e MCP_SSE_AUTHORIZATION=your_secret_token \
  -v actual-mcp-data:/data \
  ghcr.io/agigante80/actual-mcp-server:latest

{
  "mcpServers": {
    "actual-budget": {
      "command": "npx",
      "args": ["-y", "actual-mcp-server", "--stdio"],
      "env": {
        "ACTUAL_SERVER_URL": "http://localhost:5006",
        "ACTUAL_PASSWORD": "your_actual_password",
        "ACTUAL_BUDGET_SYNC_ID": "your-sync-id-here",
        "MCP_BRIDGE_DATA_DIR": "/absolute/path/to/data-dir"
      }
    }
  }
}

FAQ

支持哪些客户端？

已验证Claude Desktop、LibreChat和LobeChat兼容。任何兼容MCP的客户端都应该可以使用。

是否需要Actual Budget在同一服务器上？

不需要，Actual Budget和MCP服务器可以在不同机器上运行，只需正确配置ACTUAL_SERVER_URL。

actual-mcp-server 对比