AI导哈

Copilot Money MCP 服务器

Copilot Money MCP 服务器是一个非官方集成服务，用于从本地 Firestore 缓存读取数据并通过 GraphQL 端点写入数据，适用于个人财务管理。

  • by dakaneye
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 dakaneye/copilot-money-mcp

使用说明

副驾驶货币mcp

MCP服务器 复制货币.

非官方整合。读取来自Copilot Money Mac应用程序维护的本地Firestore缓存；写入到Copilot的私有GraphQL端点。使用风险自负。

先决条件

  • macOS --读者依赖于Copilot Money Mac应用程序的磁盘缓存。
  • Copilot Money Mac应用程序 安装并打开至少一次。应用程序填充 ~/Library/Containers/com.copilot.production/Data/Library/Application Support/firestore/...，此服务器解析读取。如果应用程序从未在此计算机上运行过，则读取失败 LOCAL_CACHE_MISSING.
  • Node.js 20+。

安装

npm install -g @dakaneye-js/copilot-money-mcp

然后登录以启用写入工具（读取不需要身份验证）：

copilot-auth login

登录流程基于魔术链接：

  1. 输入您的Copilot Money电子邮件。
  2. 检查收件箱中是否有来自Copilot的登录电子邮件。
  3. 从电子邮件中复制登录URL并将其粘贴回终端。
  4. ID令牌存储在macOS钥匙串中。有效期约为60分钟。

没有浏览器自动化，没有密码，也没有后台守护进程。当令牌过期时，写入工具返回 TOKEN_EXPIRED 然后你重新跑 copilot-auth login.

配置

克劳德桌面版 --添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

克劳德代码 --添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

命令行界面

copilot-auth login     # Magic-link authentication
copilot-auth logout    # Clear stored credentials and tokens
copilot-auth status    # Show current login and token expiry

工具

阅读 （来自本地缓存--无网络）： get_transactions, get_accounts, get_categories, get_tags, get_recurring, get_budgets, get_cache_status

写 （GraphQL，需要有效令牌）： categorize_transaction, review_transaction, unreview_transaction, tag_transaction, untag_transaction

批量: bulk_categorize, bulk_tag, bulk_review

聪明的: suggest_categories

所有阅读回复包括 meta.cacheUpdatedAt 这样你就可以知道本地数据有多新鲜。使用 get_cache_status 查看每个实体的计数和上次更新的时间戳。

故障排除

  • LOCAL_CACHE_MISSING --请至少打开一次Copilot Money Mac应用程序，然后重试。
  • LOCAL_CACHE_LOCKED --Mac应用程序持有LevelDB写锁。退出应用程序并重试。
  • TOKEN_EXPIRED / NOT_AUTHENTICATED --奔跑 copilot-auth login 并粘贴登录URL。

许可证

麻省理工学院

相关 MCP