# Xero MCP服务器
## 基本信息
- Slug: `xeroapi-xero-mcp-server`
- Source: modelscope
- Publisher: @XeroAPI/xero-mcp-server
- Categories: 金融 / customer-data-platforms
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@XeroAPI/xero-mcp-server
## 简介
一种模型上下文协议（MCP）服务器实现，提供对Xero会计和业务功能的标准访问，通过MCP启用联系人管理、发票创建和账目管理等操作。
## 安装提示

```bash
注意：如果您正在使用 [Node Version Manager](https://github.com/nvm-sh/nvm)，请将 `"command": "npx"` 部分更改为可执行文件的完整路径，例如在 Mac / Linux 上为 `your_home_directory/.nvm/versions/node/v22.14.0/bin/npx`，在 Windows 上为 `"your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx"` #### 2. Bearer Token 如果要在运行时支持多个 Xero 账户并允许 MCP 客户端根据需要执行认证流程（如 PKCE），则这是更好的选择。 在这种情况下，请使用以下配置：
```

## MCP Server 详情

# Xero MCP 服务器

这是一个为 Xero 实现的 Model Context Protocol (MCP) 服务器。它提供了 MCP 协议与 Xero API 之间的桥梁，允许以标准化的方式访问 Xero 的会计和业务功能。

## 功能

- Xero OAuth2 认证支持自定义连接
- 联系人管理
- 会计科目表管理
- 发票创建和管理
- 符合 MCP 协议

## 先决条件

- Node.js（v18 或更高版本）
- npm 或 pnpm
- 一个具有 API 凭据的 Xero 开发者账户

## 文档和链接
* [Xero 公共 API 文档](https://developer.xero.com/documentation/api/)
* [Xero API 探索器](https://api-explorer.xero.com/)
* [Xero OpenAPI 规范](https://github.com/XeroAPI/Xero-OpenAPI)
* [Xero-Node 公共 API SDK 文档](https://xeroapi.github.io/xero-node/accounting)
* [开发者文档](https://developer.xero.com/)

## 设置

### 创建 Xero 账户
如果您还没有 Xero 账户和组织，可以通过[这里](https://www.xero.com/au/signup/)注册免费试用版来创建一个。

我们建议首先使用演示公司开始，因为它自带一些预加载的示例数据。登录后，通过左上角的下拉菜单选择“演示公司”切换到它。您可以在任何时候通过左上角的下拉菜单导航至[我的 Xero](https://my.xero.com)重置演示公司的数据或更改国家。

注意：要使用特定于薪资的查询，地区应该是 NZ 或 UK。

### 认证
Xero MCP 服务器支持两种认证模式：

#### 1. 自定义连接
这是测试和开发时更好的选择，允许您为特定组织指定客户端 ID 和密钥。
这也是将此集成到第三方 MCP 客户端（如 Claude Desktop）时推荐的方法。

##### 配置您的 Xero 开发者账户

按照以下说明设置自定义连接：[https://developer.xero.com/documentation/guides/oauth2/custom-connections/](https://developer.xero.com/documentation/guides/oauth2/custom-connections/)

目前所有会话都需要以下范围：[scopes](src/clients/xero-client.ts#L91-L92)

##### 将 MCP 服务器与 Claude Desktop 集成

要将 MCP 服务器添加到 Claude，请转到设置 > 开发者 > 编辑配置，并将以下内容添加到您的 claude_desktop_config.json 文件中：

```json
{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
      "env": {
        "XERO_CLIENT_ID": "your_client_id_here",
        "XERO_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}
```


注意：如果您正在使用 [Node Version Manager](https://github.com/nvm-sh/nvm)，请将 `"command": "npx"` 部分更改为可执行文件的完整路径，例如在 Mac / Linux 上为 `your_home_directory/.nvm/versions/node/v22.14.0/bin/npx`，在 Windows 上为 `"your_home_directory\\.nvm\\versions\\node\\v22.14.0\\bin\\npx"`

#### 2. Bearer Token
如果要在运行时支持多个 Xero 账户并允许 MCP 客户端根据需要执行认证流程（如 PKCE），则这是更好的选择。
在这种情况下，请使用以下配置：

```json
{
  "mcpServers": {
    "xero": {
      "command": "npx",
      "args": ["-y", "@xeroapi/xero-mcp-server@latest"],
      "env": {
        "XERO_CLIENT_BEARER_TOKEN": "your_bearer_token"
      }
    }
  }
}
```


注意：如果已定义 `XERO_CLIENT_BEARER_TOKEN`，则它将优先于 `XERO_CLIENT_ID`。

### 可用的 MCP 命令

- `list-contacts`: 从 Xero 获取联系人列表
- `list-invoices`: 获取发票列表
- `list-accounts`: 获取账户列表
- `list-tax-rates` : 获取税率列表
- `list-quotes` : 获取报价单列表
- `list-credit-notes`: 获取贷项通知单列表
- `list-trial-balance`: 获取试算平衡表
- `list-profit-and-loss`: 获取损益报告
- `list-items`: 获取项目列表
- `list-bank-transactions`: 获取银行账户交易列表
- `list-payroll-employees`: 获取工资单员工列表
- `create-contact`: 创建新联系人
- `create-invoice`: 创建新发票
- `create-quote`: 创建新报价单
- `create-credit-note`: 创建新贷项通知单
- `update-contact`: 更新现有联系人
- `update-invoice`: 更新现有的草稿发票
- `update-quote`: 更新现有的草稿报价单
- `update-credit-note`: 更新现有的草稿贷项通知单

有关详细的 API 文档，请参阅 [MCP 协议规范](https://modelcontextprotocol.io/)。

## 开发者指南

### 安装

```bash
# Using npm
npm install

# Using pnpm
pnpm install
```


### 运行构建

```bash
# Using npm
npm run build

# Using pnpm
pnpm build
```


### 与 Claude Desktop 集成

要将您的 Xero MCP 服务器在开发中链接到 Claude Desktop，请转到设置 > 开发者 > 编辑配置，并将以下内容添加到您的 `claude_desktop_config.json` 文件中：

注意：对于 Windows 系统，请确保 `args` 路径中的反斜杠 `\` 已经转义，例如 `"C:\\projects\xero-mcp-server\\dist\\index.js"`

```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

## 安全性

请不要将您的 `.env` 文件或任何敏感凭据提交到版本控制系统（它已经被包含在 `.gitignore` 中作为安全默认设置。）