MCP 服务器

Bitrefill MCP Server

镜子 (jìng zi)

MCP-Mirror

开发者工具

访问服务器

README

Bitrefill MCP 服务器

一个基于 TypeScript 的 MCP 服务器，提供对 Bitrefill 服务的访问，允许您搜索礼品卡、手机充值等。此服务器实现了模型上下文协议，以向 AI 助手公开 Bitrefill 功能。

工作原理

该服务器使用模型上下文协议 (MCP) 与 Claude 和类似的 AI 助手进行通信。它：

作为使用 stdio 进行通信的独立进程运行
注册用于访问 Bitrefill 服务的资源和工具
与 Bitrefill API 交互以提供产品搜索和详细信息
返回可由 AI 助手处理的结构化 JSON 响应

架构

应用服务器遵循以下架构：

src/
├── index.ts                # 主要入口点
├── constants/              # 静态数据
│   ├── categories.ts       # 产品类别
│   └── payment_methods.ts  # 支付方式
├── handlers/               # MCP 请求处理程序
│   ├── resources.ts        # 资源端点
│   └── tools.ts            # 工具实现
├── schemas/               # 数据验证模式
│   ├── detail.ts           # 产品详细信息响应类型
│   ├── invoice.ts          # 发票模式
│   ├── misc.ts            # 杂项模式
│   ├── order.ts            # 订单模式
│   └── search.ts           # 搜索参数和响应类型
├── services/              # API 服务
│   ├── invoices.ts         # 发票服务
│   ├── misc.ts            # 杂项服务
│   ├── orders.ts           # 订单服务
│   ├── products.ts         # 产品详细信息服务
│   └── search.ts           # 搜索功能
└── utils/                 # 实用函数
    ├── index.ts            # 错误日志记录等
    └── api/                # API 客户端
        ├── authenticated.ts # 经过身份验证的 API 客户端
        ├── base.ts         # 基本 API 客户端
        └── public.ts       # 公共 API 客户端

特性

资源

bitrefill://product-types - Bitrefill 上可用的产品类型列表
bitrefill://categories/{type} - 特定产品类型的可用类别列表（例如，bitrefill://categories/gift-cards）

工具

search - 搜索礼品卡、esim、手机充值等
- 必需：query（例如，“Amazon”、“Netflix”、“AT&T”或“*”表示全部）
- 可选：country、language、limit、skip、category
detail - 获取有关产品的详细信息
- 必需：id（产品标识符）
categories - 获取完整的产品类型/类别映射
- 无需参数
create_invoice - 创建用于购买产品的新发票（需要 API 密钥）
- 必需：products（要包含在发票中的产品数组）
  - 每个产品都需要：product_id
  - 可选产品字段：quantity、value、package_id、phone_number、email、send_email、send_sms
- 必需：payment_method（以下之一：“balance”、“bitcoin”、“lightning”）
- 可选：webhook_url、auto_pay
get_invoices - 检索发票列表，并可选择进行过滤
- 可选：start、limit、after、before
get_invoice - 按 ID 检索特定发票的详细信息
- 必需：id（发票标识符）
pay_invoice - 支付未付发票（仅适用于“balance”支付方式）
- 必需：id（发票标识符）
get_orders - 检索订单列表，并可选择进行过滤
- 可选：start、limit、after、before
get_order - 按 ID 检索特定订单的详细信息
- 必需：id（订单标识符）
unseal_order - 显示特定订单的 ID 的代码和 PIN
- 必需：id（订单标识符）
get_account_balance - 检索您的帐户余额
- 无需参数
ping - 检查 Bitrefill API 是否可用
- 无需参数

配置

API 密钥设置

要使用所有依赖于 Bitrefill API 的工具（除了 search、categories 和 detail），您需要设置 Bitrefill API 凭据：

创建一个 Bitrefill 帐户
通过在此表单上提交请求来申请开发者 API 密钥 this form
在根目录中创建一个 .env 文件（您可以从 .env.example 复制）

添加您的 Bitrefill API 凭据：

BITREFILL_API_SECRET=your_api_key_here
BITREFILL_API_ID=your_api_id_here

仅当设置了 API 凭据时，create_invoice 工具才可用。如果未设置 API 凭据，则该工具将不会注册，也不会出现在可用工具列表中。

开发

安装依赖项：

npm install

构建服务器：

npm run build

对于具有自动重建功能的开发：

npm run watch

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

Inspector 将提供一个 URL 以访问浏览器中的调试工具。

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Bitrefill：

npx -y @smithery/cli install @bitrefill/bitrefill-mcp-server --client claude

Claude Desktop

在以下位置添加服务器配置：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "bitrefill": {
      "command": "npx",
      "args": ["-y", "bitrefill-mcp-server"],
      "env": {
        "BITREFILL_API_SECRET": "your_api_key_here",
        "BITREFILL_API_ID": "your_api_id_here"
      }
    }
  }
}

Cline

打开 Cline 扩展设置
打开“MCP 服务器”选项卡
单击“配置 MCP 服务器”
添加服务器配置：

{
  "mcpServers": {
    "github.com/bitrefill/bitrefill-mcp-server": {
      "command": "npx",
      "args": ["-y", "bitrefill-mcp-server"],
      "disabled": false,
      "autoApprove": ["search", "detail", "categories"],
      "env": {
        "BITREFILL_API_ID": "your_api_id_here",
        "BITREFILL_API_SECRET": "your_api_key_here"
      }
    }
  }
}

其他 Cline 配置选项：

disabled：设置为 false 以启用服务器
autoApprove：不需要每次使用都显式批准的工具列表

Cursor

打开 Cursor 设置
打开“功能”设置
在“MCP 服务器”部分中，单击“添加新的 MCP 服务器”
选择一个名称，然后选择“command”作为“类型”
在“命令”字段中，输入以下内容：

npx -y bitrefill-mcp-server

（可选）如果您使用的是 create_invoice 工具，请添加环境变量：
- BITREFILL_API_SECRET: your_api_key_here
- BITREFILL_API_ID: your_api_id_here

Docker

您还可以使用 Docker 运行服务器。首先，构建镜像：

docker build -t bitrefill-mcp-server .

然后运行容器：

docker run -e BITREFILL_API_SECRET=your_api_key_here -e BITREFILL_API_ID=your_api_id_here bitrefill-mcp-server

对于开发，您可能想要将源代码挂载为卷：

docker run -v $(pwd):/app --env-file .env bitrefill-mcp-server

推荐服务器

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要，从而实现与 Curri API 的交互。