Whooing MCP

哇mcp

](https://www.npmjs.com/package/whooing-mcp)

MCP服务器 Whooing（嗡嗡） 个人理财——管理交易、查看支出、资产负债表、预算等。

设置

1.获取API凭据

1. 首选 Whoing应用程序设置
2. 注意你的 app_id, token，以及 signature
3. 找到你的 section_id 从API或URL

2.配置环境

export WHOOING_APP_ID=3
export WHOOING_TOKEN=your_token
export WHOOING_SIGNATURE=your_signature
export WHOOING_SECTION_ID=your_section_id

或者创建一个 .env 文件（参见 .env.example).

用法

stdio模式（克劳德代码、克劳德桌面）

npx whooing-mcp

HTTP模式（守护进程）

npx whooing-mcp --http --port 8182

Claude代码配置(~/.mcp.json)

{
  "mcpServers": {
    "whooing": {
      "command": "npx",
      "args": ["whooing-mcp"],
      "env": {
        "WHOOING_APP_ID": "3",
        "WHOOING_TOKEN": "...",
        "WHOOING_SIGNATURE": "...",
        "WHOOING_SECTION_ID": "..."
      }
    }
  }
}

Claude桌面配置

{
  "mcpServers": {
    "whooing": {
      "command": "npx",
      "args": ["whooing-mcp"],
      "env": {
        "WHOOING_APP_ID": "3",
        "WHOOING_TOKEN": "...",
        "WHOOING_SIGNATURE": "...",
        "WHOOING_SECTION_ID": "..."
      }
    }
  }
}

工具

• 日期使用 YYYYMMDD 格式。默认值：本月（1日到今天）。
• 日历月使用 YYYYMM 格式。默认值：当月。
• whooing_entries 在从Whooing获取日期范围结果后应用过滤器。使用更大的 limit 在搜索繁忙时段时。
• whooing_search_entries 首先使用Whoing的服务器端过滤器(item, memo、账户、金额范围），并用 max 需要时使用光标。
• account_name 不区分大小写匹配帐户标题，因此 account_name: "Game" 可以将结果缩小到游戏费用类别，而无需先查找其帐户ID。
• 当 account_name 如果匹配多个帐户，搜索工具会将查询拆分为每个帐户，这样每个请求仍然可以使用Whooing的服务器端帐户过滤器。
• min_money 和 max_money 过滤器 whooing_entries 按金额。
• query 和 keywords 对双方的比赛 item 和 memo; item_contains 和 memo_contains 瞄准一个领域。
• item 和 memo 浏览Whoing的原始搜索语法。使用这些进行精确的项目匹配， * 通配符、项目详细信息括号、备注和术语，以及 ! 除外责任。
• sort_column 接受 entry_date, item, money, total, l_account_id，或 r_account_id; sort_order 接受 desc 或 asc.
• 在调用Whooing之前，会验证条目列表日期范围，因为 entries.json 每次请求最多支持一年。
• 为了高效地进行广泛搜索，请选择 item_contains, memo_contains、帐户筛选器和通用金额筛选器 keywords; query 被优化为服务器端项目或备忘录搜索。
• whooing_duplicate_candidates 将具有相同日期、金额、帐户和项目的条目分组；集 include_memo 使备忘录成为复制密钥的一部分。使用帐户/项目/金额过滤器来保持重复扫描的效率。
• whooing_account_activity 接受其中之一 account_id 或 account_name 并且仅总结匹配的条目。
• 搜索工具将内部Whoing请求限制为 max_api_calls 保持在API价格指导范围内。
• whooing_account_activity 还尝试Whooing的特定于帐户的聚合API，用于每日更改、项目总计和客户端总计。
• whooing_monthly_summary 用途 report_summary.json 和 rows_type=month 直接月度收入/支出总额。
• whooing_bulk_add_entries 在创建每一行之前验证其帐户ID，并报告部分失败。
• section_id 默认为 WHOOING_SECTION_ID 有人是。
• 写入工具会自动从帐户缓存中解析帐户类型。使用 whooing_accounts 首先查找帐户ID。

作为守护进程运行（macOS launchd）

创建 ~/Library/LaunchAgents/com.whooing.mcp.plist:

    Labelcom.whooing.mcp
    ProgramArguments
    
        /opt/homebrew/bin/npx
        whooing-mcp
        --http
        --port
        8182
    
    EnvironmentVariables
    
        WHOOING_APP_ID3
        WHOOING_TOKENYOUR_TOKEN
        WHOOING_SIGNATUREYOUR_SIGNATURE
        WHOOING_SECTION_IDYOUR_SECTION_ID
        PATH/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin
    
    KeepAlive
    RunAtLoad
    StandardOutPath/tmp/whooing-mcp.log
    StandardErrorPath/tmp/whooing-mcp.err

chmod 600 ~/Library/LaunchAgents/com.whooing.mcp.plist
launchctl load ~/Library/LaunchAgents/com.whooing.mcp.plist

发展

git clone https://github.com/jmjeong/whooing-mcp.git
cd whooing-mcp
npm install
npm run build
node dist/cli.js

许可证

麻省理工学院