MCP & Agent Skills · 开放生态

把账套变成
懂财税的 AI 数字员工

原生支持 Model Context Protocol 协议与 Agent Skills 规范。连入任意智能体，即刻驱动记账、对账、结账与报税。

GitHub 开源仓库 ★ 3

未登录也可阅读全部配置；签发令牌需要先登录。

24 个原子账务工具
5 类客户端配置
2 级令牌权限
0 次 AI 直接入账

01 / 概念

双轮驱动：MCP 是手脚，Skills 是大脑

只连 MCP，AI 会「查账」；再挂技能包，AI 才「会做账」。两者叠加，才是完整的数字员工。

MCP · 工具协议

AI 的「手和眼」

把账套能力暴露成 24 个原子工具：查余额、拉流水发票、给对账建议、跑结账体检、出申报作业包、读资产台账。任何兼容 MCP 的客户端挂载后，AI 就能读懂你的账。

19 只读5 草稿1 个端点

叠加

Skills · 技能包

AI 的「专业大脑」

封装中国小微财税业务 SOP，例如已落地的 solobooks-tax-filing 报税伴侣。Agent 会遵循「先拉税局底账比对 → 逆向排查漏记发票 → 补记凭证 → 预填税表」的完整工作流。

1 个已发布技能2 个在研

不可逾越的四条安全红线

开放能力不等于交出账本钥匙。这四条写在代码里，不是营销话术。

令牌分级，最小权限

只读令牌只能查账；「读写草稿」才允许调用 propose_*。令牌绑定单一公司，可随时吊销，吊销立即生效。

AI 只起草，不入账

所有写入都落成 pending 待确认草稿，必须你在产品内逐笔确认才生成凭证。关账动作根本不对外暴露。

不碰税局账密，不代点提交

报税技能包全程零凭据接触；表单填完即停，最终「提交申报」必须老板本人点击。

全程留痕，可审计

每次工具调用记录令牌指纹、参数摘要、耗时与成败；默认每分钟 60 次限流，异常调用有告警。

24 个原子工具，全部按账套隔离

令牌绑定单一公司，跨账套一律查不到。只读 19 个 + 草稿 5 个，连上客户端后每个工具的用法会由 AI 自己读取。

账目与凭证5

get_month_summarylist_entriesget_entry_detailsearch_booksget_company_profile

票据与流水5

list_invoice_entrieslist_bank_statementslist_unmatchedget_agingget_advance_balances

结账与资产6

run_close_checksgenerate_close_reportpreview_accrualspreview_asset_actionslist_fixed_assetslist_intangible_assets

税务与待办3

get_filing_deadlinesgenerate_filing_packagelist_todos

写入草稿5

propose_voucherpropose_voucherspropose_matchpropose_accrualpropose_asset_closure

需「读写草稿」权限，产出全部是待确认草稿

02 / 接入

主流 AI 客户端配置实战

五类客户端，同一套端点与令牌。配置结构几乎一致，选你手上正在用的那个。

把令牌粘进来，下面的配置会自动填好

令牌在签发时只显示一次，所以无法自动读取。

WorkBuddy

腾讯 · AI 办公工作台

Streamable HTTP（远程端点 + Bearer 令牌）

WorkBuddy 把 MCP 服务统一叫「连接器」。挂上梭罗记账后，在对话里勾选连接器就能直接查账、跑结账体检、起草凭证。

01
先在梭罗记账签发令牌
「我的 → AI 连接（MCP）」→ 新建令牌，权限按需选「只读」或「读写草稿」，复制 sbk_ 开头的明文（只显示一次）。
02
打开连接器面板
WorkBuddy 左侧导航进入「连接器」→ 切到「自定义连接器」→ 添加 MCP 服务；也可以直接编辑本地 mcp.json 配置文件。
03
填入端点与鉴权头
服务地址填本页给出的 MCP 端点，请求头加一行 Authorization: Bearer <令牌>。保存后点「信任」激活。
04
在对话里勾选并试用
新建对话，输入框左下角「+ → 连接器」勾选 solobooks，问一句「帮我查上个月收支汇总」即可验证。

怎么确认接上了

连接器列表里 solobooks 显示绿色「已连接」；对话中工具调用会显示 mcp__solobooks__* 前缀。

改完配置文件必须重启客户端，或在连接器页点「重新连接」，否则新服务不会被加载。
客户端只信任 HTTPS 端点；本地调试请用 http://127.0.0.1:8001/mcp，不要用局域网 IP。

配置代码已为 Windows 高亮文件路径

JSON自定义连接器配置（mcp.json）

%USERPROFILE%\.workbuddy-ai\mcp.json（新版）/ %USERPROFILE%\.workbuddy\mcp.json（旧版）你的系统

{
  "mcpServers": {
    "solobooks": {
      "url": "http://127.0.0.1:8001/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

令牌等同密码：不要提交到 Git、不要发群、不要写进截图。

连不上？先看这四条

返回 401 / 无效或已失效的访问令牌

令牌只显示一次，丢了只能重新签发。另外确认没有多复制空格、没有把 sbk_ 前缀丢掉、令牌没被吊销或过期。

连接成功但工具列表是空的

多为令牌绑定的公司与当前账套不匹配，或令牌只有 read 权限却去找 propose_*。到「我的 → AI 连接」核对权限与绑定公司。

调用报「调用过于频繁」

默认每个令牌每分钟 60 次。批量场景请合并查询条件、减少轮次，而不是提高频率。

AI 说它不能记账 / 只能生成草稿

这是设计如此。写入工具只产生待确认草稿，回到梭罗记账「待确认」列表逐笔确认后才会生成凭证。

03 / 技能包

从「单步查账」到「端到端办事」

MCP 给工具，Skills 给方法。挂上技能包，AI 才会按财税 SOP 一步步走完复杂业务。

安装方式

1
拿到技能包
从开源仓库克隆，或直接下载 skills/ 目录。每个技能包是一个独立文件夹，核心是 SKILL.md。
2
放进客户端的技能目录
支持 Agent Skills 规范的客户端（WorkBuddy / Claude Code 等）扫描 skills/ 目录；把整个 solobooks-tax-filing 文件夹放进去即可被识别。
3
同时挂上 MCP 服务
技能包只描述「怎么做」，取数要靠 MCP。所以 solobooks MCP 必须已连接，报税技能还需要一个浏览器 MCP（Chrome DevTools 或 Playwright）。
4
用一句话触发
「去电子税务局报这个季度的增值税」——技能描述里的触发条件命中后，Agent 会按 SOP 一步步执行。

技能包位置

solobooks-open/skills/solobooks-tax-filing/SKILL.md

标杆技能

solobooks-tax-filing

半自动纳税申报伴侣 · 多工具联动

SoloBooks MCP（取数） Chrome DevTools / Playwright MCP（操作税局页面）

拉税局底账

在已登录的电子税务局页面读取应申报清册、金税归集的开票销售额、历史待弥补亏损与已预缴税额。全程只读快照，不碰账密。

账 ↔ 税逆向对账

调 generate_filing_package 取账套测算值，与税局底账逐项比对。税局额度更大 = 有票没记账，Agent 会定位到具体发票。

阻塞拦截 / 补记草稿

结账体检未过或存在重大差异时严禁填表，先列阻塞原因；确认漏记的，用 propose_voucher 起草补记凭证，等你确认。

预填 + 高亮，停在提交前

把免税额、实际利润额填进申报表并黄色高亮标记，输出核对清单。绝不点「提交申报」——那一下必须由你亲手点。

最后一步永远是「人」：AI 停在提交按钮前，输出核对清单，由老板本人点击提交。

在路上

月末结账五项体检

一键跑完账证 / 账账 / 账实 / 账表 / 税表检查，阻塞项直接给修复动作。

流水批量对平

微信、网银流水与账目批量勾稽，重复入账与漏记一次清干净。

04 / 共建

开源生态与开发者共建

代码、技能包、接入文档全部开放。私有化部署跑在自己的机器上，数据不出门。

alan8182/solobooks-open

后端、前端、MCP 服务与技能包同仓维护，Issues 与 PR 都欢迎。

Star 仓库 3 提 Issue

自托管部署

Docker Compose 一条命令起服务，端点即插即用。

docker compose -f deploy/docker-compose.yml up -d

反代记得 proxy_buffering off 与 proxy_read_timeout 600s。

社区共建

欢迎贡献地区专属税务技能（各省电子税局适配）、行业科目模板与对账规则。

提交 PR 前先开 Issue 对齐方案
技能包请附 SKILL.md 与最小复现步骤
商务与合作：见仓库 README 联系方式

把账套变成懂财税的 AI 数字员工