Model Context Protocol (MCP) Server + Xero OAuth
2025.04.22
0
TypeScriptOAuth 认证远程 MCP 服务器Xero 集成金融服务开发效率
xero-mcp-server-remote 是一个支持远程 MCP 连接并内置 Xero OAuth 的 Model Context Protocol (MCP) 服务器。它部署在 Cloudflare Workers 上，可以作为 OAuth 服务器与 MCP 客户端交互，同时作为 OAuth 客户端与 Xero 的 OAuth 服务器交互。该服务器提供了工具管理、用户认证、数据访问控制等功能，适用于需要集成 Xero 服务的金融和开发场景。
View on GitHub
Overview
基本能力
产品定位
xero-mcp-server-remote 是一个基于 Cloudflare Workers 的 MCP 服务器，支持远程 MCP 连接并内置 Xero OAuth 认证。
核心功能
- 支持远程 MCP 连接
- 内置 Xero OAuth 认证
- 提供工具管理功能（如
add,userInfo,listOrganisations,listContacts,generateImage） - 支持基于用户身份的访问控制
- 使用 Cloudflare KV 存储和 Durable Objects 管理状态
适用场景
- 需要集成 Xero 服务的金融应用
- 开发需要远程 MCP 服务器的项目
- 需要基于用户身份控制工具访问权限的场景
工具列表
add: 基本数学计算工具userInfo: 获取用户信息listOrganisations: 列出 Xero 组织listContacts: 列出 Xero 联系人generateImage: 生成图像（受限制的工具）
常见问题解答
- 如何解决 Claude Desktop 不支持远程 MCP 服务器的问题？ 通过配置 Claude Desktop 的配置文件，指定 MCP 服务器的连接方式。
- 如何限制特定用户访问
generateImage工具？ 在ALLOWED_USERS配置中添加允许的用户邮箱。
使用教程
使用依赖
- 安装 Node.js 和 npm
- 安装 Wrangler CLI
npm install -g wrangler
安装教程
- 克隆仓库并安装依赖
git clone <repo-url>
cd xero-mcp-server-remote
npm install
- 创建 Xero OAuth 应用并设置回调 URL
- 设置环境变量
wrangler secret put XERO_CLIENT_ID
wrangler secret put XERO_CLIENT_SECRET
wrangler secret put COOKIE_ENCRYPTION_KEY
- 创建 KV 命名空间
wrangler kv:namespace create "OAUTH_KV"
- 部署
wrangler deploy
调试方式
- 本地开发模式
wrangler dev
- 使用 Inspector 测试
npx @modelcontextprotocol/inspector@latest
输入 http://localhost:8788/sse 或远程服务器地址进行连接测试。