Xero MCP Server

Xero MCP Server

site icon
2025.04.17 40
TypeScript会计系统集成财务自动化金融服务
Xero MCP Server 是一个实现 Model Context Protocol (MCP) 的服务,作为 Xero API 与 MCP 协议之间的桥梁,提供标准化的访问方式,以便使用 Xero 的会计和业务功能。
View on GitHub

Overview

基本能力

产品定位

Xero MCP Server 旨在通过 MCP 协议标准化访问 Xero 的会计和业务功能,适用于需要集成 Xero 会计系统的开发者和企业。

核心功能

  • Xero OAuth2 认证与自定义连接
  • 联系人管理
  • 账户图表管理
  • 发票创建与管理
  • 符合 MCP 协议

适用场景

  • 企业会计系统集成
  • 自动化发票处理
  • 财务报告生成
  • 业务联系人管理

工具列表

  • list-contacts: 获取联系人列表
  • list-invoices: 获取发票列表
  • list-accounts: 获取账户列表
  • list-tax-rates: 获取税率列表
  • list-quotes: 获取报价单列表
  • list-credit-notes: 获取信用票据列表
  • list-trial-balance: 获取试算平衡报告
  • list-profit-and-loss: 获取损益报告
  • list-items: 获取项目列表
  • create-contact: 创建新联系人
  • create-invoice: 创建新发票
  • create-quote: 创建新报价单
  • create-credit-note: 创建新信用票据
  • update-contact: 更新现有联系人
  • update-invoice: 更新草稿发票
  • update-quote: 更新草稿报价单
  • update-credit-note: 更新草稿信用票据

常见问题解答

  • 如何配置 Xero 开发者账户? 按照 Xero 开发者文档 设置自定义连接。
  • 如何保护敏感凭证? 不要将 .env 文件或任何敏感凭证提交到版本控制。

使用教程

使用依赖

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

安装教程

# 使用 npm
npm install

# 使用 pnpm
pnpm install

调试方式

# 使用 npm
npm run build

# 使用 pnpm
pnpm build

集成 Claude Desktop

claude_desktop_config.json 文件中添加以下配置:

{
  "mcpServers": {
    "xero": {
      "command": "node",
      "args": ["insert-your-file-path-here/xero-mcp-server/dist/index.js"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

许可证

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