Moneybird MCP 服务器

模型上下文协议 (MCP) 服务器通过 API 将 Claude 等 AI 助手连接到 Moneybird 会计软件。

特征

• 联系人管理：列出、检索、过滤、创建和更新联系人

  • 按创建日期、更新日期、名称等进行高级过滤

• 财务数据：访问销售发票、财务账户和付款

• 业务运营：管理产品、项目和时间条目

• 自定义请求：向 Moneybird 端点发出自定义 API 请求

• 交互式助手：Moneybird 助手的预配置提示

Related MCP server: Ledger CLI MCP Server

新发展

• 增强联系人过滤：使用 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. 使用您的 Moneybird 凭证创建一个 .env 文件：

   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. 重新启动 Claude Desktop以应用更改

4. 在 Claude 聊天输入框中输入/mcp moneybird连接到 MCP 服务器

使用示例

基本联系人列表

概述

该服务器允许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. 使用您的 Moneybird API 凭证编辑.env文件：

   • 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

与人工智能助手一起使用

此 MCP 服务器与任何支持模型上下文协议 (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

• 限制网络访问

执照

麻省理工学院