Xero MCP 服务器

此 MCP 服务器允许客户端与 Xero 会计软件 交互。

开始使用

1. 确保已安装 node 和 Claude Desktop。

2. 在 Xero 中创建一个 OAuth 2.0 应用程序以获取 CLIENT_ID 和 CLIENT_SECRET。

   • 创建一个免费的 Xero 用户帐户（如果您没有）。
   • 登录到 Xero 开发者中心 https://developer.xero.com/app/manage/
   • 点击 New app（新建应用）
   • 输入您的应用程序的名称
   • 选择 Web app（Web 应用）
   • 提供一个有效的 URL（可以是任何有效的 URL，例如 https://www.myapp.com）
   • 输入重定向 URI：http://localhost:5000/callback
   • 勾选以接受条款和条件，然后点击 Create app（创建应用）
   • 在屏幕的左侧选择 Configuration（配置）
   • 点击 Generate a secret（生成密钥）

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 页面不会自动关闭）

   隐私警报：完成 Xero OAuth2 流程后，您的 Xero 数据可能会通过您使用的 LLM。 如果您正在进行测试，则应授权到您的 Xero 演示公司。

工具

• authenticate

  使用 OAuth2 验证 Xero 身份

• 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

  检索销售报价

例子

• "可视化我上个月的财务状况"

  <img src="https://github.com/john-zhang-dev/assets/blob/main/xero-mcp/demo1.jpg?raw=true" width=50% height=50%>

• "跟踪我上周的支出"

  <img src="https://github.com/john-zhang-dev/assets/blob/main/xero-mcp/demo2.jpg?raw=true" width=50% height=50%>

• "将月度报表中的所有交易作为收款添加到我的收入帐户（帐户代码 201）"

许可证

MIT