Xero MCP Server

Xero Accounting API 的 MCP (Model Context Protocol) 服务器，让 Claude Desktop 用自然语言操作 Xero 云会计系统。

功能

读取（9 个工具）

组织信息、联系人、科目表、发票、银行交易、付款、贷项通知单、产品目录、手工日记账
审计轨迹查询

写入（6 个工具）

创建联系人、发票、银行交易、手工日记账
记录付款、上传附件

报表（4 个工具，本地计算）

试算平衡表、应收账款账龄、应付账款账龄、损益表

两种运行模式

本地 STDIO 模式

pip install -r requirements.txt

# 设置环境变量
export XERO_CLIENT_ID=xxx
export XERO_CLIENT_SECRET=xxx
export XERO_TENANT_ID=xxx
export XERO_REFRESH_TOKEN=xxx

python server.py

Claude Desktop 配置见 claude_desktop_config_example.json

远程 HTTP 模式（多租户）

cp .env.example .env
# 编辑 .env 填写凭证和域名

docker compose up -d --build

详细部署教程见部署教程.md 和 Claude_Desktop_MCP配置教程.md

架构

Claude Desktop ──HTTPS──▶ Nginx ──HTTP──▶ MCP Server ──OAuth 2.0──▶ Xero API

Nginx 负责 SSL 终结和反向代理
MCP Server (Starlette + uvicorn) 处理 MCP 协议
多租户通过 API Key 隔离，OAuth Token 存在 SQLite

文件说明

文件	用途
`server.py`	本地 STDIO 模式入口
`server_remote.py`	远程 HTTP 多租户模式入口
`xero_client.py`	Xero API 客户端，自动刷新 Token
`aggregations.py`	本地报表计算（试算平衡/账龄/损益）
`Dockerfile` / `docker-compose.yml`	Docker 部署
`部署教程.md`	服务器部署详细步骤
`Claude_Desktop_MCP配置教程.md`	Claude Desktop 配置教程（含踩坑记录）

依赖

Python 3.12+
mcp >= 2.0.0
uvicorn / starlette
requests