zaim MCP

zaim mcp

Zaim家庭收支簿API的非公式MCP服务器。可以从MCP客户端（如Claude Desktop）访问Zaim收支数据。

备注：本项目包括扎伊姆不是官方的，而是个人开发运营的。

需要的东西

• v18+
• Zaim开发者帐户 -获取OAuth凭据所需

安装，安装

1.获取Zaim API认证信息

Zaim开发商在中注册应用程序并获取控制台密钥/控制台安全。

2.运行安装向导

npx -y @highbridgedragon/zaim-mcp init

向导将引导您：

1. Consumer Key / Consumer Secret の入力
2. 在浏览器中登录Zaim，获取访问令牌
3. 选择要使用的MCP客户端（Claude Desktop、Claude Code、Cursor、Windsurf、VS Code）
4. 自动写入配置文件

安装完成后，重新启动MCP客户端即可开始使用。

手动设定

如果不使用向导而手动设置，请在MCP客户端的配置文件中添加以下内容。

克劳德桌面版 (claude_desktop_config.json):

{
  "mcpServers": {
    "zaim": {
      "command": "npx",
      "args": ["-y", "@highbridgedragon/zaim-mcp"],
      "env": {
        "ZAIM_CONSUMER_KEY": "...",
        "ZAIM_CONSUMER_SECRET": "...",
        "ZAIM_ACCESS_TOKEN": "...",
        "ZAIM_ACCESS_TOKEN_SECRET": "..."
      }
    }
  }
}

在Windows的情况下 "command": "cmd", "args": ["/c", "npx", "-y", "@highbridgedragon/zaim-mcp"] 中所述修改相应参数的值。

可用工具

工具｜说明｜ |--------|------| | zaim_verify 确认认证状态，返回用户信息 | zaim_get_money 取得收支记录（可按日期、类别、类别进行筛选） | zaim_get_categories 获取用户类别列表 | zaim_get_genres 获取用户类型列表 | zaim_get_accounts 获取用户的帐户列表 | zaim_get_default_categories 获取默认类别列表 | zaim_get_currencies 获取可用货币列表

开発

开发需要Bun。

git clone https://github.com/HighBridgeDragon/zaim-mcp.git
cd zaim-mcp
bun install
bun run prepare

bun run start         # MCPサーバー起動
bun run test          # ユニットテスト
bun run check         # lint + format + typecheck

许可证

ISC