Moneybird MCP Server

一个通过API连接AI助手（如Claude）与Moneybird会计软件的模型上下文协议（MCP）服务器。

功能

• 联系人管理：列出、检索、筛选、创建和更新联系人
  • 使用创建日期、更新日期、姓名等进行高级筛选
• 财务数据：访问销售发票、财务账户和支付信息
• 业务操作：管理产品、项目和时间条目
• 自定义请求：向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 Desktop设置

要在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（推荐版本18或更高）
• 具有API访问权限的Moneybird账户
• Moneybird API令牌

设置

1. 克隆此仓库：

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

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
• 限制网络访问

许可证

MIT