Xero MCP Server

Xero MCP Server

site icon
2025.03.31 12
TypeScript财务管理会计软件集成财务数据分析金融服务
Xero MCP Server 是一个允许客户端与 Xero 会计软件交互的 MCP 服务器。它通过 OAuth2 认证与 Xero 集成,提供了一系列财务工具,如创建银行交易、管理联系人、获取财务报表等。适用于需要进行财务管理和数据分析的场景。
View on GitHub

Overview

基本能力

产品定位

Xero MCP Server 是一个中间件服务,用于连接客户端与 Xero 会计软件,实现财务数据的交互和管理。

核心功能

  • 通过 OAuth2 认证与 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: 获取销售报价

常见问题解答

  • 隐私警告: 完成 Xero OAuth2 流程后,您的 Xero 数据可能会通过您使用的 LLM。如果进行测试,应授权给您的 Xero Demo Company
  • Xero 登录页面不会自动关闭: 在首次访问 Xero 工具时,Xero 登录页面会弹出要求您的同意。完成认证流程后,需要手动关闭网页。

使用教程

使用依赖

  1. 安装 nodeClaude Desktop

安装教程

  1. 在 Xero 中创建 OAuth 2.0 应用以获取 CLIENT_IDCLIENT_SECRET
  2. 创建免费的 Xero 用户账户(如果没有)
  3. 登录 Xero 开发者中心 https://developer.xero.com/app/manage/
  4. 点击 New app
  5. 输入应用名称
  6. 选择 Web app
  7. 提供有效的 URL(可以是任何有效的 URL,例如 https://www.myapp.com)
  8. 输入重定向 URI: http://localhost:5000/callback
  9. 勾选接受条款和条件并点击 Create app
  10. 在屏幕左侧选择 Configuration
  11. 点击 Generate a secret

  12. 修改 claude_desktop_config.json 文件 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" } } } }

  13. 重启 Claude Desktop

调试方式

  • 首次访问 Xero 工具时,会弹出 Xero 登录页面要求您的同意。完成认证流程后,手动关闭网页。
  • 检查 claude_desktop_config.json 文件中的配置是否正确。
  • 确保 Xero 开发者中心的应用配置正确。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。