mcpField
T
TILL

TILL

本地服务
tillbooks.ch金融数据11 天前更新
代码仓库访问官网

关于 TILL

TILL 是面向瑞士中小企业的免费开源 ERP，覆盖会计、销售、采购、库存、项目和 MWST。AI Agent 可通过 MCP 工具操作本地账本，Studio 会显示操作结果；账本保存在用户控制的 SQLite 文件中。

主要功能

  1. 01双重记账及多公司账簿
  2. 02瑞士 MWST 申报数据和 eCH-0217 导出
  3. 03报价、发票、采购及 QR 账单
  4. 04导入 camt.053 并生成 pain.001 文件
  5. 05库存、项目、联系人和报告管理

适用场景

  1. 01管理瑞士中小企业的日常账务
  2. 02生成发票、报价和 QR 账单
  3. 03导入银行对账单并确认建议分录
  4. 04从 bexio CSV 或 Excel 导出数据迁移

MCP 相关

通过本地 stdio MCP 服务向客户端提供 ERP 功能工具；无需账号或 API 密钥。Agent 与 Studio 使用同一账本文件，敏感操作默认需经用户批准。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "tillbooks-tillbooks": {
      "command": "npx",
      "args": [
        "-y",
        "tillbooks"
      ],
      "env": {
        "TILL_DB_PATH": "<TILL_DB_PATH>",
        "TILL_SUPPORT_DIR": "<TILL_SUPPORT_DIR>"
      }
    }
  }
}
启动命令npx -y tillbooks
需要配置的环境变量
TILL_DB_PATHPath to your TILL SQLite ledger. Leave unset for the default (~/.till/till.db); TILL bundles no database.
TILL_SUPPORT_DIRWhere TILL keeps machine-scoped state (diagnostics, backups). Leave unset for the default (~/.till).

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmtillbooks0.1.0

工具

779

收录的工具列表 · 更新于 2 周前

参数类型必填说明
namestring是
legalFormstring否
baseCurrencystring否
idempotencyKeystring否
fiscalYearStartstring否

详细介绍

TILL

可信赖的独立账簿库。 面向瑞士中小企业、以 Agent 为先的 ERP。

TILL 是一款面向瑞士小型企业的免费开源（MIT）ERP：涵盖销售、采购、付款、库存、项目、账簿和 MWST。每项功能都以 MCP 工具形式提供，共 822 个，因此你的 AI Agent 可以操作它，而 Studio（你工作的应用）会向你展示它做了什么。它适用于 Claude Desktop、Cursor 及其他能够启动本地 stdio 服务的 MCP 客户端。TILL 在你的电脑上运行，也可以运行在你自行托管的服务上。你的账簿以单个 SQLite 文件的形式保存在那台设备上，我们的服务不会留存副本。

默认情况下，Agent 在记账、转移资金、授予访问权限或永久删除数据之前，都会等待你确认：它先起草，再由你批准。对于上述每个领域，你都可以决定它是否能自行操作。许多可以撤销的操作，例如创建草稿和修改联系人详情，无需询问即可执行；Agent 发出的每次调用也都会记录下来。这个开关适用于连接到 TILL 的 Agent。能够操控浏览器或在你的电脑上运行命令的 Agent 可以冒充你行事：请把 TILL 交给你的 Agent，而不是把浏览器或命令行交给它。

公开测试版，版本 1.0.0-beta.1。 TILL 背后的公司 Nomadik GmbH 也用它记账。如果你将账簿迁移到 TILL，请让旧系统继续运行，直到两边数字一致；并先阅读测试版目前还不能做什么。

为什么选择 TILL

TILL 使用 MIT 许可证，完全免费。你可以运行、修改并长期使用它，用户、公司或账目数量均不受限制；账簿始终保存在你掌控的电脑上。它专为瑞士账簿的特点打造：

  • QR-bill（Swiss QR-Rechnung），符合结构化地址标准
  • MWST 税率为 8.1%、3.8% 和 2.6%，支持实际法和余额税率法，并可直接根据账簿生成 MWST-Abrechnung
  • 开箱即用的 Kontenrahmen KMU 科目表
  • ISO 20022 银行业务：导入 camt.053 对账单，导出 pain.001 付款文件
  • de-CH 和 en

TILL 涵盖的功能

  • 会计：复式账簿、期间锁定和年结、外币及重估、应计项目、固定资产，以及在一次安装中管理多家公司。
  • MWST：按期间生成 MWST-Abrechnung，与账簿核对，并生成可上传至 ESTV ePortal 的 eCH-0217 文件。
  • 销售：报价、订单、送货单、带 QR-bill 的发票、贷项通知单、周期性发票、催款函和未结项目清单。
  • 采购：含进项税的供应商账单、采购订单、收货、费用报销，以及可在网银中由你放行的 pain.001 付款文件。TILL 绝不会发送付款。
  • 银行：导入网银提供的 camt.053 对账单。银行收件箱会为能匹配的每一行提出记账建议，由你确认。
  • 联系人和 CRM、产品和库存（仓库、批次和序列号、库存估值）、项目和工时跟踪、文档、报告。
  • 迁移：导入 bexio 的 CSV 和 Excel 导出文件（不提供 bexio API 连接）、用于试用导入的测试公司，以及将 TILL 的数字与旧系统核对的并行运行。固定资产、库存和工资历史记录不会迁移；上一年度的日记账则会存放在实时账簿旁的只读档案中。

账簿不可更改

已过账分录只能追加，且不可修改。更正必须通过冲销分录完成，不能直接破坏性编辑，这与实际会计的做法完全一致。过账操作具有幂等性：重复过账不会重复计数。这些要求都由测试套件验证，而不只是 README 中的承诺。

安装和运行

你需要在 macOS 或 Linux 上安装 Node.js 22 或更高版本。最快的方式是让你的 Agent 来完成： tillbooks.ch/en/start 提供了适用于 Claude Code（终端或桌面应用）、Cursor 或 Windsurf 的设置提示词：它会安装 TILL、启动 Studio、提示你打开演示公司，并自动连接。手动操作只需两条命令：

npm install -g tillbooks@beta
till up

请保留 @beta。在 beta 结束前，npm 上不带后缀的 tillbooks 仍是旧版 0.1.0，没有 Studio。

till up 会在 http://127.0.0.1:8788 启动 Studio，并在浏览器中打开。它只监听你自己的机器。首屏提供三种操作：新建账簿、恢复备份，或在现有数据库文件上重新启动 TILL。下方的 Try the demo 会创建一个包含示例分录的演示工作区。你的账簿存放在 ~/.till/till.db；设置 TILL_DB_PATH 可将其存放在其他位置。

要连接 Claude Desktop 或 Cursor 等 MCP 客户端，请将其指向 stdio 服务。无需账户或 API 密钥：

{
  "mcpServers": {
    "tillbooks": {
      "command": "npx",
      "args": ["-y", "tillbooks@beta", "mcp"]
    }
  }
}

在 Claude Code 中，添加同一服务只需一行：

claude mcp add tillbooks -- npx -y tillbooks@beta mcp

Agent 和 Studio 使用同一个文件，因此 Agent 执行的操作会显示在 Studio 中。

要参与开发 TILL，请从检出代码构建：

npm run setup            # installs the core and the Studio dependencies
npm run build:all        # builds the core into dist/ and the Studio into app/dist/
node bin/till.mjs up

CONTRIBUTING.md 提供完整的开发环境设置说明，快速入门指南介绍首次运行流程。

你的数据

  • 你的账簿保存在一个 SQLite 文件中。你可以复制它、备份它，也可以用标准工具打开它。
  • 无需账户、无需注册，也没有遥测。TILL 不会向外报告你的信息或你的使用情况。只有在你启用错误详情记录后，相关信息才会被记录；这些信息保存在你的机器上，只有你主动发送反馈邮件时才会离开你的机器。
  • 你可以随时以开放且有文档说明的格式导出整家公司；恢复备份时会创建一个全新的工作区，不会影响你已有的工作区。

Beta 版暂不支持的功能

  • 不支持工资核算。TILL 会为你的工资服务提供商导出员工数据，并记录你导入的工资日记账。工资单、AHV 和 Swissdec 仍由服务提供商处理。
  • 不支持申报 MWST。TILL 会准备 MWST-Abrechnung 并生成 eCH-0217 文件。你需要自行上传文件，并在 ESTV ePortal 中完成申报。
  • 不支持按已收取对价（vereinnahmte Entgelte）计算 MWST。TILL 按约定对价（vereinbarte Entgelte）计算 Abrechnung，并会拒绝采用另一种方式设置的期间。
  • 暂不支持发送电子邮件。TILL 会生成发票、报价单或付款提醒的 PDF，你需要用自己的邮件程序发送。通过你自己的邮件账户发送邮件计划在后续 beta 版本中推出。
  • 仅支持德语（de-CH）和英语，暂不支持法语或意大利语。
  • 没有移动应用，也没有 Windows 应用。我们不在 Windows 上进行测试；在 Windows 上使用的文档化方案是在 Agent 中运行 TILL。
  • 此版本不支持直接连接银行。EBICS 客户端已构建完成，并已在 ZKB 的测试平台上通过测试，但连接银行的模块尚未发布（发布后将采用 MIT 许可证）。 在此之前，你需要从 eBanking 下载 camt.053 对账单并导入。
  • 在自己的计算机上，只有在你启动备份时才会运行备份（Data & Backup，“Back up now”），不会按计划自动运行。请将备份文件另存到存放账簿的计算机以外的位置。（自托管方案会通过 Litestream 持续复制账簿。）
  • 只有在你自己托管的服务器上，才能让多人共用一本账簿。本地应用仅供一台计算机使用。
  • 不支持发送 eBill、电子签名或在线客户门户。

文档

使用前须知

TILL 用于记账，因此建议花两分钟阅读 DISCLAIMER.md：TILL 不提供税务建议， 你仍需对自己的申报负责，并且在依赖 Beta 版之前，应先并行运行一段时间。

Beta 期间，我们免费提供力所能及的帮助；也提供付费协助，帮助你完成设置以及从 bexio 迁移。 详情请见 SUPPORT.md。

贡献

许可证

MIT，版权所有 (c) 2026 Nomadik GmbH。请参阅 LICENSE。

TILL 是一个独立项目，与 bexio AG 或任何其他会计服务供应商均无关联，未获其认可，也并非基于其产品衍生而来。它是依据公开文档独立实现的项目。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。