AI导哈

Moneybird会计软件MCP服务器

一个连接AI助手与Moneybird会计软件的MCP服务器，提供联系人管理、财务数据访问和业务运营功能。

  • by vanderheijden86
  • TypeScript
  • 本地部署
  • 29 星标
  • 更新于
在 GitHub 查看 vanderheijden86/moneybird-mcp-server

使用说明

Moneybird MCP服务器

模型上下文协议（MCP）服务器，通过API将Claude等人工智能助手连接到Moneybird会计软件。

特性

  • 联系人管理：列出、检索、筛选、创建和更新联系人
    • 按创建日期、更新日期、名称等进行高级筛选
  • 财务数据：访问销售发票、财务账户和付款
  • 业务运营：管理产品、项目和时间条目
  • 自定义请求：向Moneybird端点发出自定义API请求
  • 互动助理：Moneybird助手的预配置提示

新发展

  • 增强联系人筛选：使用Moneybird的高级查询语法筛选联系人
    • 按创建日期筛选： created_after:2023-01-01 00:00:00 UTC
    • 按更新日期筛选： updated_after:2023-01-01 10:45:35 UTC
    • 按属性筛选： first_name:value等等。
  • 改进了错误处理：更好的错误消息和恢复
  • 性能优化：大型数据集的响应分块
  • TypeScript集成：通过Zod模式验证实现完全类型安全

安装说明

基本设置

  1. 安装软件包:

    npm install -g moneybird-mcp-server

  2. 创建.env文件 使用您的Moneybird凭据：

    MONEYBIRD_API_TOKEN=your_api_token
MONEYBIRD_ADMINISTRATION_ID=your_administration_id

  3. 运行服务器:

    npx moneybird-mcp-server

Claude桌面设置

要在Claude Desktop中设置此MCP服务器，请执行以下操作：

  1. 全局安装软件包 如果你还没有：

    npm install -g moneybird-mcp-server

  2. 创建或编辑 Claude Desktop配置文件（通常位于 ~/Library/Application Support/Claude/claude_desktop_config.json)包括MCP服务器配置：

    {
  "mcpServers": {
    "moneybird": {
      "command": "npx",
      "args": [
        "-y",
        "moneybird-mcp-server"
      ],
      "env": {
        "MONEYBIRD_API_TOKEN": "your_api_token_here",
        "MONEYBIRD_ADMINISTRATION_ID": "your_administration_id_here"
      }
    }
  }
}

  3. 重新启动克劳德桌面 应用更改

  4. 连接到MCP服务器 通过打字 /mcp moneybird 在Claude聊天输入中

用法示例

基本联系人列表

概述

该服务器允许AI助手使用模型上下文协议与您的Moneybird会计数据进行交互。它 提供各种工具以：

  • 列出并检索联系人
  • 查看销售发票
  • 检查财务账户
  • 访问产品和项目
  • 查看时间条目
  • 制作自定义Moneybird API请求

先决条件

  • Node.js（建议使用v18或更高版本）
  • 具有API访问权限的Moneybird帐户
  • Moneybird API代币

设置

  1. 克隆此存储库：

    git clone https://github.com/vanderheijden86/moneybird-mcp-server.git
cd moneybird-mcp-server

  2. 安装依赖项：

    npm install

  3. 创建 .env 示例中的文件：

    cp .env.example .env

  4. 编辑 .env 使用您的Moneybird API凭证提交文件：

    • MONEYBIRD_API_TOKEN：您的Moneybird API代币（在生成https://moneybird.com/user/applications)
    • MONEYBIRD_ADMINISTRATION_ID：您的Moneybird管理ID（登录时在URL中找到）
    • MCP_SERVER_PORT：运行MCP服务器的端口（默认值：3000）

运行服务器

发展：

npm run dev

生产：

npm run build
npm start

使用AI助手

此MCP服务器与支持模型上下文协议的任何AI助手兼容。跑步后，你可以 通过提供服务器URL将其连接到您的AI助手：

http://your-server-address:3000

可用工具

服务器提供以下工具：

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

安全

此服务器应部署适当的安全措施，因为它可以访问您的Moneybird数据。 考虑：

  • 在安全代理后面运行
  • 为MCP服务器实施身份验证
  • 使用HTTPS
  • 限制网络访问

许可证

麻省理工学院

相关 MCP