Moneybird MCP Server

🚀 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 模式驗證。

📦 安裝指南

基本安裝

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。

💻 使用示例

基本聯繫人列表

暫未提供具體代碼示例，後續可根據實際需求補充。

⚠️ 安全注意事項

⚠️ 重要提示

• 請將服務器部署在受信任的網絡後端。
• 實施身份驗證機制，保障數據安全。
• 使用 HTTPS 加密，防止數據傳輸過程中被竊取。
• 嚴格限制訪問權限，避免數據洩露。

📄 許可證

本項目採用 MIT 許可證。