Skip to main content
Glama
Usage And Billing MCP Server

Usage And Billing MCP Server

README.md
# Usage And Billing MCP Server

[English](./README_EN.md) | 简体中文 | [繁體中文](./README_ZH-TW.md)

用于访问 Usage And Billing API 的 MCP 服务器。

## 🚀 使用 EMCP 平台快速体验

**[EMCP](https://sit-emcp.kaleido.guru)** 是一个强大的 MCP 服务器管理平台,让您无需手动配置即可快速使用各种 MCP 服务器!

### 快速开始:

1. 🌐 访问 **[EMCP 平台](https://sit-emcp.kaleido.guru)**
2. 📝 注册并登录账号
3. 🎯 进入 **MCP 广场**,浏览所有可用的 MCP 服务器
4. 🔍 搜索或找到本服务器(`bach-usage_and_billing`)
5. 🎉 点击 **"安装 MCP"** 按钮
6. ✅ 完成!即可在您的应用中使用

### EMCP 平台优势:

- ✨ **零配置**:无需手动编辑配置文件
- 🎨 **可视化管理**:图形界面轻松管理所有 MCP 服务器
- 🔐 **安全可靠**:统一管理 API 密钥和认证信息
- 🚀 **一键安装**:MCP 广场提供丰富的服务器选择
- 📊 **使用统计**:实时查看服务调用情况

立即访问 **[EMCP 平台](https://sit-emcp.kaleido.guru)** 开始您的 MCP 之旅!


---

## 简介

这是一个 MCP 服务器,用于访问 Usage And Billing API。

- **PyPI 包名**: `bach-usage_and_billing`
- **版本**: 1.0.0
- **传输协议**: stdio


## 安装

### 从 PyPI 安装:

```bash
pip install bach-usage_and_billing
```

### 从源码安装:

```bash
pip install -e .
```

## 运行

### 方式 1: 使用 uvx(推荐,无需安装)

```bash
# 运行(uvx 会自动安装并运行)
uvx --from bach-usage_and_billing bach_usage_and_billing

# 或指定版本
uvx --from bach-usage_and_billing@latest bach_usage_and_billing
```

### 方式 2: 直接运行(开发模式)

```bash
python server.py
```

### 方式 3: 安装后作为命令运行

```bash
# 安装
pip install bach-usage_and_billing

# 运行(命令名使用下划线)
bach_usage_and_billing
```

## 配置

### API 认证

此 API 需要认证。请设置环境变量:

```bash
export API_KEY="your_api_key_here"
```

### 环境变量

| 变量名 | 说明 | 必需 |
|--------|------|------|
| `API_KEY` | API 密钥 | 是 |
| `PORT` | 不适用 | 否 |
| `HOST` | 不适用 | 否 |



### 在 Cursor 中使用

编辑 Cursor MCP 配置文件 `~/.cursor/mcp.json`:


```json
{
  "mcpServers": {
    "bach-usage_and_billing": {
      "command": "uvx",
      "args": ["--from", "bach-usage_and_billing", "bach_usage_and_billing"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### 在 Claude Desktop 中使用

编辑 Claude Desktop 配置文件 `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "bach-usage_and_billing": {
      "command": "uvx",
      "args": ["--from", "bach-usage_and_billing", "bach_usage_and_billing"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}
```


## 可用工具

此服务器提供以下工具:


### `get_accounts_customers`

Get accounts

**端点**: `GET /accounts`



---


### `get_account_customer`

Get sub-account

**端点**: `GET /accounts/{account_id}`


**参数**:

- `account_id` (string) *必需*: Example value: 



---


### `get_meters`

Get meters

**端点**: `GET /meters`



---


### `create_meter`

Create meter

**端点**: `POST /meters`



---


### `get_plans_of_a_product`

Get plans of a product

**端点**: `GET /plans`



---


### `create_plan`

Create plan of a product.

**端点**: `POST /plans`



---


### `report_usage`

Report Usage

**端点**: `POST /usage`



---


### `get_usage`

Get Usage

**端点**: `GET /usage`



---


### `get_product_items`

Get product items

**端点**: `GET /products/{product_id}/overview`


**参数**:

- `product_id` (string) *必需*: Example value: 



---


### `create_product`

Create product

**端点**: `POST /products`



---


### `get_products`

Get Products

**端点**: `GET /products`



---


### `get_product_item`

Get  product item

**端点**: `GET /product_items/{id}`


**参数**:

- `id` (string) *必需*: Example value: 



---


### `create_product_item`

Create product item of a product.

**端点**: `POST /product_items`



---


### `get_product`

Get product

**端点**: `GET /products/{id}`


**参数**:

- `id` (string) *必需*: Example value: 



---


### `delete_product`

Delete product

**端点**: `DELETE /products/{id}`


**参数**:

- `id` (string) *必需*: Example value: 



---


### `get_meter`

Get meter

**端点**: `GET /meter/{meter_id}`


**参数**:

- `meter_id` (string) *必需*: Example value: 



---


### `get_my_account_profile`

Get my account

**端点**: `GET /profile`



---


### `health_check`

Health check

**端点**: `GET /health`



---



## 技术栈

- **传输协议**: stdio
- **HTTP 客户端**: httpx


## 许可证

MIT License - 详见 [LICENSE](./LICENSE) 文件。

## 开发

此服务器由 [API-to-MCP](https://github.com/BACH-AI-Tools/api-to-mcp) 工具生成。

版本: 1.0.0

TDQS

C2.5/5.0

Scored across 18 tools

Disambiguation4/5

Most tools have clearly distinct purposes targeting specific resources like meters, products, plans, and usage, with minimal overlap. However, 'get_account_customer' and 'get_accounts_customers' could cause minor confusion due to similar naming, and 'health_check' is a utility that stands apart from the core billing domain.

Naming Consistency4/5

The naming follows a consistent verb_noun pattern (e.g., create_meter, get_product) with clear CRUD operations, which aids predictability. A minor deviation is 'get_plans_of_a_product' which uses 'of_a' instead of a simpler pattern like 'get_product_plans', slightly breaking the consistency.

Tool Count4/5

With 18 tools, the count is reasonable for a billing and usage management domain, covering various entities like products, meters, and accounts. It's slightly on the higher side but well-scoped, as each tool serves a distinct function without appearing bloated.

Completeness4/5

The tool set provides comprehensive CRUD coverage for core resources (e.g., products, meters, usage) and includes utility functions like health checks. A minor gap is the lack of update or delete operations for meters, plans, and product items, which might require workarounds but doesn't severely hinder core workflows.

Maintenance

ActivityInactive
ResponsivenessNo recent community issues