Xero费用管理协议服务器

Xero会计系统的模型上下文协议服务器,支持发票、账单、费用(银行交易)和费用报销,采用PKCE认证。

  • by muness
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 muness/xero-expenses-mcp

使用说明

施乐公司支出mcp

用于Xero计费的MCP(模型上下文协议)服务器。通过PKCE身份验证支持发票、账单、费用(银行交易)和费用报销。

特性

  • 发票(ACCREC) -创建销售发票以发送给客户
  • 账单(ACCPAY) -创建稍后要支付的账单
  • 开支 -为已支付的费用创建“花钱”银行交易
  • 费用报销 -创建收据并提交报销费用申请
  • 附件 -将PDF和图像附加到发票、账单、费用和收据上
  • PKCE认证 -桌面应用程序OAuth流(不需要客户端密钥)

安装

npx xero-expenses-mcp

或全局安装:

npm install -g xero-expenses-mcp

Xero应用程序设置

  1. 首选 Xero开发者门户
  2. 创建新应用程序:
    • 应用名称:您的选择(例如“费用管理器”)
    • 集成类型:“移动或桌面应用程序”(使用PKCE,无需保密)
    • 重定向URI: http://localhost:3000/callback
  3. 注意你的 客户端ID

Claude代码配置

添加到您的Claude Code MCP设置中:

{
  "mcpServers": {
    "xero-expenses": {
      "command": "npx",
      "args": ["xero-expenses-mcp"],
      "env": {
        "XERO_CLIENT_ID": "YOUR_CLIENT_ID"
      }
    }
  }
}

或者使用CLI:

claude mcp add xero-expenses -- npx xero-expenses-mcp

然后在shell中设置环境变量或 .env 文件。

环境变量

变量 必填 描述
XERO_CLIENT_ID 是 您的Xero应用程序的客户端ID
XERO_CLIENT_SECRET 否 仅适用于Web应用程序(非PKCE)
XERO_REDIRECT_URI 否 默认值: http://localhost:3000/callback

认证

首次使用时,服务器将打开Xero OAuth浏览器。身份验证后,令牌存储在 ~/.xero-mcp/token.json.

可用工具

帐户和联系人

  • xero_list_accounts -列出支出账户/类别
  • xero_list_bank_accounts -列出银行账户
  • xero_list_contacts -搜索供应商/联系人
  • xero_list_users -列出组织用户(用于费用报销)

发票(应收账款)

  • xero_create_invoice -创建销售发票以发送给客户
  • xero_attach_file_to_invoice -将文件附加到发票上

账单(应付账款)

  • xero_create_bill -为未来付款创建账单
  • xero_attach_file -将文件附加到账单上

费用(银行交易)

  • xero_create_expense -创建“花钱”交易
  • xero_attach_file_to_expense -将文件附加到费用中

费用报销(2026年2月弃用)

  • xero_create_expense_claim -创建收据+费用报销
  • xero_attach_file_to_receipt -将文件附加到收据上

示例用法

在克劳德代码中:

"Create an expense for $45.50 lunch at Cafe Example on 2024-01-15, categorize as Business Meals (account 620)"

克劳德将使用 xero_create_expense_claim 工具包括:

{
  "vendorName": "Cafe Example",
  "amount": 45.50,
  "description": "Lunch",
  "accountCode": "620",
  "date": "2024-01-15"
}

令牌存储

代币存储在 ~/.xero-mcp/token.json。要重新进行身份验证,请删除此文件。

许可证

麻省理工学院