🚀 Xero MCP 服务器
此 MCP 服务器允许客户端与 Xero 会计软件 进行交互，为用户提供便捷的会计数据交互体验。
🚀 快速开始
准备工作
- 确保安装了 Node.js 和 Claude Desktop。
获取认证信息
- 在 Xero 中创建一个 OAuth 2.0 应用以获取 CLIENT_ID 和 CLIENT_SECRET：
- 如果没有 Xero 账户，请先注册。
- 登录到 Xero 开发者中心：https://developer.xero.com/app/manage/
- 点击“新建应用”
- 输入应用名称
- 选择“Web 应用”
- 提供一个有效的 URL（例如 https://www.myapp.com）
- 设置重定向 URI：
http://localhost:5000/callback - 同意条款与条件并点击“创建应用”
- 在左侧菜单中选择“配置”
- 点击“生成密钥”
配置文件修改
- 修改
claude_desktop_config.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"
}
}
}
}
重启应用
- 重启 Claude Desktop。
身份验证
- 当客户端首次访问 Xero 工具时，会弹出一个 Xero 登录页面以获取您的授权。完成身份验证流程后，请手动关闭网页（因为当前版本无法自动关闭）。
⚠️ 重要提示
完成 Xero OAuth2 流程后，您的 Xero 数据可能会经过您使用的 LLM。如果您在进行测试，请授权访问 Xero 演示公司。
✨ 主要特性
此 MCP 服务器提供了一系列工具，方便客户端与 Xero 会计软件进行交互：
authenticate：使用 OAuth2 进行身份验证。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：获取销售报价单。
💻 使用示例
基础用法
以下是一些使用该服务器的示例：
- "可视化我过去一个月的财务状况"
- "跟踪我上周的支出"
- "将每月对账单中的所有交易添加到我的收入账户（账号代码 201）作为收款"
📄 许可证
本项目采用 MIT License。