Moneybird MCP Server

Moneybird MCP Server

site icon
2025.03.24 1
JavaScript会计软件集成自动化数据处理金融服务
Moneybird MCP Server 是一个基于模型上下文协议(MCP)的服务器,用于将AI助手(如Claude)与Moneybird会计软件通过API连接起来。它提供了丰富的功能,包括联系人管理、财务数据访问、业务运营管理等,并支持自定义API请求。
View on GitHub

Overview

基本能力

产品定位

Moneybird MCP Server 是一个中间件,旨在通过MCP协议将AI助手与Moneybird会计软件集成,实现自动化数据处理和交互。

核心功能

  • 联系人管理:列出、检索、筛选、创建和更新联系人,支持高级筛选(如创建日期、更新日期、名称等)。
  • 财务数据访问:访问销售发票、财务账户和付款信息。
  • 业务运营管理:管理产品、项目和时间条目。
  • 自定义请求:支持向Moneybird的API端点发起自定义请求。
  • 交互式助手:预配置的Moneybird助手提示。

适用场景

  • 自动化会计数据处理
  • 财务报告生成
  • 客户关系管理
  • 项目和时间跟踪

工具列表

  • list_contacts:列出所有联系人
  • get_contact:获取特定联系人的详细信息
  • list_sales_invoices:列出所有销售发票
  • get_sales_invoice:获取特定销售发票的详细信息
  • list_financial_accounts:列出所有财务账户
  • list_products:列出所有产品
  • list_projects:列出所有项目
  • list_time_entries:列出所有时间条目
  • moneybird_request:向Moneybird API发起自定义请求

常见问题解答

  • 如何获取API令牌?:在Moneybird的“用户应用”页面生成。
  • 如何找到管理ID?:登录Moneybird后,从URL中获取。
  • 如何确保安全?:建议使用HTTPS、安全代理和网络访问限制。

使用教程

使用依赖

  • Node.js(推荐v18或更高版本)
  • Moneybird账户(具有API访问权限)
  • Moneybird API令牌

安装教程

  1. 全局安装包: bash npm install -g moneybird-mcp-server
  2. 创建.env文件并填写Moneybird凭证: MONEYBIRD_API_TOKEN=your_api_token MONEYBIRD_ADMINISTRATION_ID=your_administration_id
  3. 运行服务器: bash npx moneybird-mcp-server

调试方式

  • 开发模式运行: bash npm run dev
  • 生产模式运行: bash npm run build npm start

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。