yimu-mcp
一木记账(yimubill.com)的 MCP 服务:把一木记账网页版的能力封装成 AI 可调用的工具, 在支持 MCP 的客户端里就能直接读写你的账本。
能做什么
- 三种登录方式:扫码登录(推荐,手机一扫即可)、邮箱密码登录、直接配置登录令牌
- 看账:全量/增量同步账单、按账本分页查询、账单总数、删除记录
- 管账:新增、更新、删除账单、资产、账本、标签、转账、借贷、分类、报销、退款、附件
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @powercess/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add powercess-yimu-mcp -- npx -y @powercess/yimu-mcp@0.2.0在終端機中執行。
{ "mcpServers": { "powercess-yimu-mcp": { "command": "npx", "args": [ "-y", "@powercess/[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
一木记账(yimubill.com)的 MCP 服务:把一木记账网页版的能力封装成 AI 可调用的工具, 在支持 MCP 的客户端里就能直接读写你的账本。
一木记账(yimubill.com)网络 MCP 服务器:扫码/邮箱登录、增量同步、账本/账单/资产/分类/标签/转账/借贷/报销/退款等全部网页接口的读写封装
需要 Node ≥ 23.4 或 Bun ≥ 1.x。
安装:
npm install -g @powercess/yimu-mcp
yimu-mcp # 启动 MCP 服务
本地开发:
npm install && npm run build # Node
# 或
bun install && bun run dev # Bun,直接运行,无需构建
建议通过环境变量提供配置,账号信息不进仓库:
不再自动读取启动目录中的 yimu.config.json。需要文件配置时,请使用 --config /绝对路径/yimu.config.json
或 YIMU_CONFIG 指向由你管理的可信文件。优先级为命令行参数 > 环境变量 > 显式文件 > 默认值;
显式文件不存在、不是有效 JSON 对象或使用相对路径时,启动会失败。API 地址始终受官方域名限制。
令牌可从一木记账网页版浏览器开发者工具里复制请求头 token 的值。
全局安装后:
{
"mcpServers": {
"yimu": {
"command": "yimu-mcp",
"env": { "YIMU_TOKEN": "你的JWT" }
}
}
}
仓库本地方式(command 指向可执行文件):node + dist/index.js,或 bun + src/index.ts(无需构建)。
login_qr_start,二维码直接显示在对话或终端里;
手机打开一木记账 App,首页 → 更多 → 扫一扫,扫完调用 login_qr_poll 等待登录结果。login_email,填邮箱和密码即可,密码加密传输;
不传参数时自动使用环境变量 YIMU_EMAIL / YIMU_PASSWORD。YIMU_TOKEN,启动即已登录。配了
YIMU_EMAIL/YIMU_PASSWORD而未配 TOKEN 时,服务启动会自动登录获取 JWT, AI 即可直接读写账本;令牌过期后随时调login_email(无参)重新登录。 扫码/邮箱登录只返回登录状态和脱敏用户信息,JWT 留在当前工具进程内部供后续请求使用。 新 JWT 只更新内存,不写回环境变量或配置文件;重启后仍需原有有效配置或重新登录。
--print-config 对令牌和密码掩码;使用文件配置时,文件权限和保存方式由你管理。https://yimubill.com,并拒绝自动重定向;不能通过配置改为代理、HTTP 或其他域名。api_request 默认不注册,显式启用后其 raw 模式仍会脱敏。get_sts / get_sts_no_verify
不再作为 MCP 工具公开,避免把对象存储临时凭据交给模型;内部 API 方法保留。YIMU_PASSWORD 前,请确认其环境变量存储方式;优先用 YIMU_TOKEN 或扫码登录。login_qr_start login_qr_poll login_email get_me auth_statussync_pull(增量同步,默认返回摘要:计数/收支合计/最近明细/分类Top)、get_bill_count(账单总数)、
get_book_bills(账本账单分页,精简账单+收支小计)、
get_assets(资产,仅业务字段)、get_currency(币种)、get_category_info(分类)、
get_share_accounts(共享账本)、get_account_members(账本成员)、get_delete_history(删除记录)save_bill / save_bills(单条/批量新增或更新)、delete_bill(删除)save_asset save_account_book save_tag save_transfer save_lend
save_parent_category save_child_category save_reimbursement save_refund
save_bill_file save_bill_import save_asset_history(对应删除用 delete_*)parse_bill_text(一句话记账解析)、api_request(仅显式启用时,通用请求仍可读写接口)运行 npm ci --ignore-scripts 和 npm test,会先编译再执行 Node 测试。
回归测试使用模拟 API 响应、真实 MCP 内存传输和临时配置文件,不连接一木服务、不需要真实账号。
覆盖登录后继续认证、凭据输出、错误信息、恶意配置、地址校验和重定向策略。
MIT
一木记账(yimubill.com)网络 MCP 服务器:扫码/邮箱登录、增量同步、账本/账单/资产/分类/标签/转账/借贷/报销/退款等全部网页接口的读写封装
{ "mcpServers": { "powercess-yimu-mcp": { "command": "npx", "args": [ "-y", "@powercess/[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
@powercess/yimu 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 一木记账(yimubill.com)网络 MCP 服务器:扫码/邮箱登录、增量同步、账本/账单/资产/分类/标签/转账/借贷/报销/退款等全部网页接口的读写封装