JinDaGe - moneybird-mcp-server MCP Details

article

README

🚀 Moneybird MCP 服务器

Moneybird MCP 服务器是一个模型上下文协议（MCP）服务器，它能将 AI 助手（如 Claude）连接到 Moneybird 会计软件的 API，实现两者的数据交互。

🚀 快速开始

此服务器允许 AI 助手使用模型上下文协议与你的 Moneybird 数据交互。主要功能包括列出、获取和过滤关键业务数据，安装步骤简单，几分钟内即可完成设置。同时，使用时需注意安全事项，包括网络限制和身份验证建议。本项目采用 MIT 许可证。

✨ 主要特性

联系人管理：可以列出、获取、过滤、创建和更新联系人，还能使用创建日期、更新日期、姓名和其他属性进行高级过滤。
财务数据：支持访问销售发票、财务账户和付款等财务相关数据。
业务操作：能够管理产品、项目和时间条目等业务内容。
自定义请求：可对 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 模式验证。

📦 安装指南

基本安装

安装包：
```
npm install -g moneybird-mcp-server
```

创建.env 文件，包含你的 Moneybird 凭证：

MONEYBIRD_API_TOKEN=your_api_token
MONEYBIRD_ADMINISTRATION_ID=your_administration_id

运行服务器：
```
npx moneybird-mcp-server
```

Claude Desktop 安装

在 Claude Desktop 中设置此 MCP 服务器：

全局安装包（如果尚未安装）：
```
npm install -g moneybird-mcp-server
```

创建或编辑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"
      }
    }
  }
}

重启 Claude Desktop以应用更改。
连接到 MCP 服务器，在 Claude 聊天输入中键入/mcp moneybird。

💻 使用示例

基本联系人列表

暂未提供具体代码示例，后续可根据实际需求补充。

⚠️ 安全注意事项

⚠️ 重要提示

请将服务器部署在受信任的网络后端。

实施身份验证机制，保障数据安全。

使用 HTTPS 加密，防止数据传输过程中被窃取。

严格限制访问权限，避免数据泄露。

📄 许可证

本项目采用 MIT 许可证。

moneybird-mcp-server