yimu-mcp
一木记账(yimubill.com)的 MCP 服务:把一木记账网页版的能力封装成 AI 可调用的工具, 在支持 MCP 的客户端里就能直接读写你的账本。
能做什么
- 三种登录方式:扫码登录(推荐,手机一扫即可)、邮箱密码登录、直接配置登录令牌
- 看账:全量/增量同步账单、按账本分页查询、账单总数、删除记录
- 管账:新增、更新、删除账单、资产、账本、标签、转账、借贷、分类、报销、退款、附件
Power your agent
पब्लिशर की अपनी कमांड। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
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 या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
一木记账(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]" ] } }}टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
@powercess/yimu stdio पर लोकल चलता है।
पिछली जाँच 2026-11-16 को हुई। 一木记账(yimubill.com)网络 MCP 服务器:扫码/邮箱登录、增量同步、账本/账单/资产/分类/标签/转账/借贷/报销/退款等全部网页接口的读写封装