Rebillia MCP Server

Rebillia MCP服务器

模型上下文协议（MCP）服务器 Rebillia公用API。它暴露了 工具 调用API，以及 资源 通过API文档，人工智能助手可以管理客户、产品、费率计划，并了解API。

特性

• 工具 –从您的MCP客户端（例如Cursor、Claude Desktop）调用Rebillia端点：

- 客户 （22个工具）-列出、获取、创建、更新、删除；发票（包括未付）、订阅、日志；地址和付款方式；费用/贷项 - 产品 （8个工具）-列出、获取、创建、更新、删除；更新状态；链接/取消链接外部产品 - 产品费率计划 （7个工具）-按产品列出、获取、创建、更新、删除；更新状态；同步 - 产品费率计划费用 （5个工具）-按产品费率计划列出，获取、创建、更新、删除（使用chargeType、chargeModel、billingPeriod、billingTiming枚举和chargeTier数组） - 订阅 （19个工具）-列出、获取、创建、更新、删除；地位；下一张账单、即将发生的费用、发票、日志、外部发票；订阅费率计划和费率计划费用（添加/更新/删除） - 发票 （8个工具）-列出、获取、创建、更新、删除；charge（卡/在线支付类型），charge_外部（离线），无效

• 交易 （4个工具）-列表（customerId、invoiceId、状态、类型、日期发件人/收件人、companyGatewayId、orderBy/sortBy、分页）、获取、退款（金额 分)，无效（仅在结算前）

- 比尔跑了 （4个工具）-列表（按已完成/待处理/错误过滤）、获取、更新（newDateTime，ISO 8601；仅待处理）、获取账单运行发票

• 网关 （9个工具）-列出全局网关（发现gblGatewayId和所需的设置密钥），列出公司网关，获取、创建、更新、删除、测试网关，获取客户端令牌，创建设置意图
• 货币 （7个工具）-列出、获取、创建、更新、删除、获取/设置默认货币
• 集成 （8个工具）-列表、获取配置、按键获取/列表；外部发票、产品、订单状态
• 运输 （2个工具）-列出运输服务，计算运输
• 过滤器 （4个工具）-列出筛选器（必填部分），创建筛选器，列出筛选器字段，删除筛选器
• 文档 （1个工具）- get_api_docs 返回概述或其他API文档作为markdown（无外部获取）
• 资源 -通过MCP资源提供API文件(rebillia://docs/*)：概述、型号、订阅状态、收费类型、网关。国家列表位于 rebillia://globals/countries （id、代码、名称）用于地址工具。全球网关 rebillia://globals/gateways （gblGatewayId，requiredFields）用于创建网关。所有文件都是独立的；使用这些或工具，而不是获取外部URL。
• 类型 –与Rebillia Public API响应形状对齐的TypeScript类型

需求

• Node.js 18+
• Rebillia API密钥（见下文）

获取API密钥

1. 首选 Rebillia设置/欢迎.
2. 选择一个计划 并继续。
3. 注册 （创建帐户）或 登录 如果您已经拥有Rebillia帐户。
4. 加入公司后，打开 仪表盘.
5. 在仪表板中， 复制您的API代币 并将其用作 REBILLIA_API_KEY 在您的环境或MCP客户端配置中。

设置

1. 克隆并安装

   cd /path/to/rebillia-mcp-server
   npm install

1. 配置环境

复制示例env文件并设置API密钥和可选的基本URL：

   cp .env.example .env

编辑 .env:

   REBILLIA_API_KEY=your_api_key_here
   REBILLIA_API_URL=https://api.rebillia.com/v1

- REBILLIA_API_KEY – 必修的。 用作 X-AUTH-TOKEN 对于所有请求。 - REBILLIA_API_URL –可选。默认为 https://api.rebillia.com/v1 （包括 /v1 用于公共API）。

1. 构建

   npm run build

用法

运行服务器

开发（无构建步骤）：

npm run dev

生产：

npm run build
npm start

或者运行二进制文件：

./node_modules/.bin/rebillia-mcp-server

服务器使用 标准 传输：它从stdin读取JSON-RPC并将响应写入stdout。MCP客户端作为子进程连接到它。

配置Claude桌面

1. 构建服务器 （如果你还没有）：

   npm run build

1. 打开Claude Desktop MCP配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加Rebillia服务器 在...之下 mcpServers:

   {
     "mcpServers": {
       "rebillia": {
         "command": "npx",
         "args": ["@rhinosaas/rebillia-mcp-server"],
         "env": {
           "REBILLIA_API_KEY": "YOUR_API_KEY",
           "REBILLIA_API_URL": "https://api.rebillia.com/v1"
         }
       }
     }
   }

1. 重新启动克劳德桌面。 Rebillia工具和资源（包括 get_api_docs)将出现。您可以要求Claude使用Rebillia API或“获取API文档”以获取概述信息。

配置光标

1. 构建服务器：

   npm run build

1. 打开光标MCP设置：

- 设置 → 光标设置 → 主控程序，或 - 直接打开MCP配置文件： - macOS/Linux： ~/.cursor/rebillia-mcp-server.json 或项目级别 .cursor/mcp.json

• 窗户： %USERPROFILE%\.cursor\rebillia-mcp-server.json

1. 添加Rebillia服务器 在MCP配置中。例子：

   {
     "mcpServers": {
       "rebillia": {
         "command": "npx",
         "args": ["@rhinosaas/rebillia-mcp-server"],
         "env": {
           "REBILLIA_API_KEY": "your_api_key_here",
           "REBILLIA_API_URL": "https://api.rebillia.com/v1"
         }
       }
     }
   }

1. 重新启动游标 或者重新加载MCP服务器。Rebillia工具和资源将在AI聊天中提供（例如“列出客户”、“获取API文档”）。

工具

响应是来自Rebillia Public API的JSON（列表端点分页，get为单个对象）。

客户（22工具）

产品（8工具）

产品费率计划（7个工具）

产品费率计划费用（5个工具）

订阅（19个工具）

发票（8个工具）

交易（4种工具）

Bill runs（4个工具）

网关（9个工具）

网关创建示例流程： （1） 呼叫 list_global_gateways （无参数）。（2）选择一个网关（例如Stripe、Braintree）并记录其 gblGatewayId 和 requiredFields（3）建立一个 setting 使用这些密钥和凭据值创建对象。（4）电话 create_gateway 说完这个 gblGatewayId 和 setting。参见 rebillia://docs/gateways 或 get_api_docs 随着 doc: "gateways" 了解全部细节。

货币（7种工具）

集成（8个工具）

发货（2个工具）

过滤器（4个工具）

文档（1个工具）

资源

API文件作为MCP资源公开在 rebillia://docs/*.使用 resources/list 然后 resources/read 使用URI，或调用 get_api_docs 工具。所有文件都是独立的；不要获取外部URL。

项目结构

src/
├── index.ts              # MCP server entry, tools + resources handlers
├── client.ts             # HTTP client for Rebillia API (X-AUTH-TOKEN)
├── types.ts              # Rebillia API types (customers, invoices, etc.)
├── services/             # API call layer (used by tools)
│   ├── customerServices.ts
│   ├── productServices.ts
│   ├── productRatePlanServices.ts
│   ├── productRatePlanChargeServices.ts
│   ├── subscriptionServices.ts
│   ├── invoiceServices.ts
│   ├── transactionServices.ts
│   ├── billRunServices.ts
│   ├── gatewayServices.ts
│   ├── globalGatewayService.ts
│   ├── countryResolverService.ts
│   ├── currencyServices.ts
│   ├── integrationServices.ts
│   ├── shippingServices.ts
│   └── filterServices.ts
├── tools/
│   ├── index.ts          # Tool registry, getToolDefinitions(), executeTool()
│   ├── types.ts          # Tool definition and handler types
│   ├── customers/        # Customer tools (22)
│   ├── products/         # Product tools (8)
│   ├── product_rate_plans/         # Product rate plan tools (7)
│   ├── product_rate_plan_charges/  # Product rate plan charge tools (5)
│   ├── subscriptions/    # Subscription tools (19)
│   ├── invoices/         # Invoice tools (8)
│   ├── transactions/     # Transaction tools (4)
│   ├── bill_runs/        # Bill run tools (4)
│   ├── gateways/         # Gateway tools (9)
│   ├── currencies/       # Currency tools (7)
│   ├── integrations/     # Integration tools (8)
│   ├── shipping/         # Shipping tools (2)
│   ├── filters/          # Filter tools (4)
│   └── docs/             # get_api_docs (1)
├── resources/
│   ├── index.ts          # listResources(), readResource()
│   └── api-docs.ts       # registerResources(), doc resources, getDocContent()
├── prompts/              # (reserved for MCP prompts)
└── types/
    └── addressInput.ts

脚本

许可证

麻省理工学院