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
   • 同意条款与条件并点击“创建应用”
   • 在左侧菜单中选择“配置”
   • 点击“生成密钥”

配置文件修改

3. 修改 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"
            }
        }
    }
}

重启应用

4. 重启 Claude Desktop。

身份验证

5. 当客户端首次访问 Xero 工具时，会弹出一个 Xero 登录页面以获取您的授权。完成身份验证流程后，请手动关闭网页（因为当前版本无法自动关闭）。

⚠️ 重要提示

完成 Xero OAuth2 流程后，您的 Xero 数据可能会经过您使用的 LLM。如果您在进行测试，请授权访问 Xero 演示公司。

✨ 主要特性

此 MCP 服务器提供了一系列工具，方便客户端与 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。