Moneybird MCP 服务器

一个模型上下文协议 (MCP) 服务器，通过 API 将 Claude 等 AI 助手连接到 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 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. 连接到 MCP 服务器，在 Claude 聊天输入中键入 /mcp moneybird

使用示例

基本联系人列表

概述

此服务器允许 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

与 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