Xero MCP

🚀 Xero MCP 服務器

此 MCP 服務器允許客戶端與 Xero 會計軟件 進行交互，為會計相關操作提供了便捷的途徑，讓用戶能夠更高效地管理財務數據。

🚀 快速開始

準備工作

1. 確保安裝了 Node.js 和 Claude Desktop。
2. 在 Xero 中創建一個 OAuth 2.0 應用以獲取 CLIENT_ID 和 CLIENT_SECRET：
   • 如果沒有 Xero 賬戶，請先註冊。
   • 登錄到 Xero 開發者中心：https://developer.xero.com/app/manage/
   • 點擊“新建應用”。
   • 輸入應用名稱。
   • 選擇“Web 應用”。
   • 提供一個有效的 URL（例如 https://www.myapp.com）。
   • 設置重定向 URI：http://localhost:5000/callback。
   • 同意條款與條件並點擊“創建應用”。
   • 在左側菜單中選擇“配置”。
   • 點擊“生成密鑰”。

配置文件修改

修改 claude_desktop_config.json 文件：

{
    "mcpServers": {
        "xero-mcp": {
            "command": "npx",
            "args": ["-y", "xero-mcp@latest"],
            "env": {
                "XERO_CLIENT_ID": "YOUR_CLIENT_ID",
                "XERO_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
                "XERO_REDIRECT_URI": "http://localhost:5000/callback"
            }
        }
    }
}

重啟與授權

1. 重啟 Claude Desktop。
2. 當客戶端首次訪問 Xero 工具時，會彈出一個 Xero 登錄頁面以獲取您的授權。完成身份驗證流程後，請手動關閉網頁（因為當前版本無法自動關閉）。

⚠️ 重要提示

完成 Xero OAuth2 流程後，您的 Xero 數據可能會經過您使用的 LLM。如果您在進行測試，請授權訪問 Xero 演示公司。

✨ 主要特性

• authenticate：使用 OAuth2 進行身份驗證。
• create_bank_transactions：創建一個或多個支出或收入交易。
• create_contacts：在 Xero 組織中創建一個或多個聯繫人。
• get_balance_sheet：獲取資產負債表報告。
• list_accounts：獲取完整的賬戶列表。
• list_bank_transactions：獲取任何支出或收入交易。
• list_contacts：獲取 Xero 組織中的所有聯繫人。
• list_invoices：獲取銷售發票或採購賬單。
• list_journals：獲取日記賬。
• list_organisations：獲取 Xero 組織詳細信息。
• list_payments：獲取發票和信用單的支付記錄。
• list_quotes：獲取銷售報價單。

💻 使用示例

基礎用法

以下是一些使用該服務器的示例：

• "可視化我過去一個月的財務狀況"
• "跟蹤我上週的支出"
• "將每月對賬單中的所有交易添加到我的收入賬戶（賬號代碼 201）作為收款"

📄 許可證

本項目採用 MIT License 進行許可。