Xero MCP Server

Xero MCP Server

site icon
2025.05.07 0
TypeScript财务管理会计服务业务集成金融服务
Xero MCP Server 是一个基于 Model Context Protocol (MCP) 的服务实现,旨在为 Xero 的会计和业务功能提供标准化访问。它通过 MCP 协议与 Xero API 之间的桥梁,支持多种财务和业务管理功能。
View on GitHub

Overview

基本能力

产品定位

Xero MCP Server 是一个专门为 Xero 会计软件设计的 MCP 协议实现,提供对 Xero API 的标准化访问,支持财务管理和业务操作。

核心功能

  • Xero OAuth2 认证(支持自定义连接和Bearer Token)
  • 联系人管理(创建、更新、列出联系人)
  • 账户图表管理
  • 发票管理(创建、更新、列出发票)
  • 多种财务报告(利润与损失、资产负债表等)
  • 工资单管理(员工、休假记录、时间表等)
  • MCP 协议合规性

适用场景

  • 企业财务管理自动化
  • 第三方应用与 Xero 的集成
  • 财务报告生成与分析
  • 工资单处理

工具列表

  • list-accounts: 列出账户
  • list-contacts: 列出联系人
  • list-invoices: 列出发票
  • list-profit-and-loss: 生成利润与损失报告
  • create-invoice: 创建发票
  • update-contact: 更新联系人
  • 其他多种财务和工资单相关命令

常见问题解答

  • 认证问题:确保正确配置了 OAuth2 凭据或 Bearer Token
  • 数据访问:某些功能(如工资单)需要特定地区的组织
  • 开发集成:Windows 路径需要正确转义反斜杠

使用教程

使用依赖

  • Node.js (v18 或更高版本)
  • npm 或 pnpm
  • Xero 开发者账户及 API 凭据

安装教程

# 使用 npm
npm install

# 使用 pnpm
pnpm install

调试方式

# 构建项目
npm run build

# 或使用 pnpm
pnpm build

集成到 Claude Desktop 的配置示例(开发环境):

{
  "mcpServers": {
    "xero": {
      "command": "node",
      "args": ["path/to/xero-mcp-server/dist/index.js"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id",
        "XERO_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

许可证

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