AccountsOS

AccountsOS MCP 服务

通过 Model Context Protocol，从任意 MCP 客户端（Claude Desktop、Claude Code、Cursor）查询实时的 AccountsOS 账簿。

AccountsOS 为 26 个国家/地区运行司法管辖区操作手册。英国是验证司法管辖区，支持实时 HMRC MTD VAT 申报。

npm： https://www.npmjs.com/package/@thriveventurelabs/accountsos-mcp

安装

选项 1：全局安装（推荐）

npm install -g @thriveventurelabs/accountsos-mcp

然后添加到 Claude Desktop 配置：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "accountsos": {
      "command": "accountsos-mcp",
      "args": [],
      "env": {
        "ACCOUNTSOS_API_KEY": "your-api-key-here"
      }
    }
  }
}

选项 2：使用 npx

{
  "mcpServers": {
    "accountsos": {
      "command": "npx",
      "args": ["--yes", "@thriveventurelabs/accountsos-mcp@latest"],
      "env": {
        "ACCOUNTSOS_API_KEY": "your-api-key-here"
      }
    }
  }
}

从 AccountsOS 设置 获取 API 密钥。

可用工具

读取操作

工具	描述
get_transactions	按筛选条件查询交易（日期、类别、金额、搜索）
get_balance	获取当前账户余额
get_deadlines	查看即将到来的税务和申报截止日期
get_vat_summary	获取任意季度的 VAT 汇总
search_documents	搜索上传的收据和发票
list_categories	列出可用的英国 GAAP 交易类别

写入操作

工具	描述
create_transaction	创建新交易（自动分类）
update_transaction	更新类别、备注或对账状态
categorize_transaction	获取交易的 AI 建议类别
create_deadline	创建新的税务／申报截止日期提醒

可用资源

资源	描述
accountsos://company	公司详情和设置
accountsos://transactions	最近的 50 笔交易
accountsos://documents	已上传的文档
accountsos://deadlines	即将到来的截止日期

示例提示词

连接后，可以尝试向 Claude 提问：

• “我的账户余额是多少？”
• “显示我上个月的交易”
• “我的下一个 VAT 截止日期是什么时候？”
• “我在软件订阅上花了多少钱？”
• “创建一笔与客户共进午餐的交易，金额为 £45”
• “我 2024 年第 4 季度的 VAT 汇总是什么？”

开发

# Install dependencies
npm install

# Build
npm run build

# Run locally (for testing)
ACCOUNTSOS_API_KEY=sk_live_xxx npm start

环境变量

变量	必需	描述
ACCOUNTSOS_API_KEY	是	你的 AccountsOS API 密钥
ACCOUNTSOS_BASE_URL	否	覆盖 API 基础 URL（默认值：https://accounts-os.com）

故障排除

服务已断开连接

查看日志：~/Library/Logs/Claude/mcp-server-accountsos.log

npx 问题

如果 npx 存在缓存问题，请改用全局安装：

npm install -g @thriveventurelabs/accountsos-mcp

免责声明

本软件提供有关英国税务和会计规则的一般指导，不能替代合格会计师或税务顾问提供的专业建议。请务必核对 HMRC 源文件，并就适用于你具体情况的事项咨询专业人士。

许可证

MIT