zaim mcp
Zaim家庭收支簿API的非公式MCP服务器。可以从MCP客户端(如Claude Desktop)访问Zaim收支数据。
> 备注:本项目包括扎伊姆不是官方的,而是个人开发运营的。
需要的东西
- Node.js v18+
- Zaim开发者帐户 -获取OAuth凭据所需
安装,安装
1.获取Zaim API认证信息
Zaim开发商在中注册应用程序并获取控制台密钥/控制台安全。
2.运行安装向导```sh
npx -y @highbridgedragon/zaim-mcp init
向导将引导您:
1. Consumer Key / Consumer Secret の入力
1. 在浏览器中登录Zaim,获取访问令牌
1. 选择要使用的MCP客户端(Claude Desktop、Claude Code、Cursor、Windsurf、VS Code)
1. 自动写入配置文件
安装完成后,重新启动MCP客户端即可开始使用。
### 手动设定
如果不使用向导而手动设置,请在MCP客户端的配置文件中添加以下内容。
**克劳德桌面版** (`claude_desktop_config.json`):```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。sh
git clone https://github.com/HighBridgeDragon/zaim-mcp.git
cd zaim-mcp
bun install
bun run prepare
``````sh
bun run start # MCPサーバー起動
bun run test # ユニットテスト
bun run check # lint + format + typecheck
许可证
ISC
