mcpField
B
Billium

Billium

ローカル
billium.to金融データ019 週間前に更新
リポジトリ公式サイト

Billium について

Billiumは、非カストディアル型の暗号資産決済SDKと、加盟店が請求書やWebhookを管理するためのMCPサーバーを提供します。MCPパッケージを通じて、ClaudeやCursorなどから管理操作を行えます。

主な機能

  1. 01暗号資産の請求書管理
  2. 02Webhookの管理
  3. 03Webhook署名の検証
  4. 04Billium用Node.js SDK

活用シーン

  1. 01決済用請求書の作成と管理
  2. 02加盟店Webhookの管理
  3. 03受信したWebhook署名の検証

MCP 対応

@billium/mcpは、MCPクライアントからBilliumの請求書とWebhookを管理できるMCPサーバーです。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "billiumhq-billium": {
      "command": "npx",
      "args": [
        "-y",
        "@billium/mcp"
      ],
      "env": {
        "BILLIUM_API_KEY": "<BILLIUM_API_KEY>",
        "BILLIUM_MERCHANT_ID": "<BILLIUM_MERCHANT_ID>",
        "BILLIUM_BASE_URL": "<BILLIUM_BASE_URL>"
      }
    }
  }
}
起動コマンドnpx -y @billium/mcp
設定が必要な環境変数
BILLIUM_API_KEYシークレットSecret API key (sk_...), from the dashboard under Settings → Developer → API keys.
BILLIUM_MERCHANT_IDMerchant ID (mer_...).
BILLIUM_BASE_URLOverride the API base URL (testing / staging environments).

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@billium/mcp0.1.3

ツール

23

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
namestringはい請求書の表示名。例："Order #1234"。
currencystringいいえ通貨コード。例：'USD'。デフォルトは USD です。
rawAmountnumberはい指定した通貨での金額（例：99.99）。
descriptionstringいいえ
redirectUrlstringいいえ支払い成功後に顧客をリダイレクトする URL。
customerNamestringいいえ
customerEmailstringいいえ
idempotencyKeystringいいえ省略可能な重複排除キー。省略すると UUID が生成され、再試行しても請求書が重複して作成されません。
customerAddressstringいいえ
customerPhoneNumberstringいいえ

詳細

Billium SDK

Billium の公式クライアントライブラリです。非カストディアル型の暗号資産決済、請求書、Webhook に対応しています。

パッケージ

パッケージバージョン説明
@billium/nodenpmNode.js SDK — 請求書、Webhook 署名の検証、Webhook の管理
@billium/mcpnpmMCP サーバー — Claude、Cursor、その他あらゆる MCP ホストから請求書と Webhook を管理

追加の言語 SDK は、リリースに合わせて packages/ 内に並列して追加されます。

クイックスタート

npm install @billium/node

import { Billium } from '@billium/node';

const billium = new Billium({
  apiKey: process.env.BILLIUM_API_KEY,
  merchantId: process.env.BILLIUM_MERCHANT_ID,
  webhookSecret: process.env.BILLIUM_WEBHOOK_SECRET,
});

const invoice = await billium.invoices.create(
  { name: 'Order #1234', rawAmount: 99.99 },
  { idempotencyKey: crypto.randomUUID() },
);

Node.js SDK の詳細については、packages/node/README.md をご覧ください。

リポジトリの構成

.
├── packages/
│   ├── node/              # @billium/node — TypeScript Node.js SDK
│   │   ├── src/           # Source
│   │   ├── tests/         # Vitest test suite
│   │   ├── README.md      # Public-facing docs (rendered on npmjs.com)
│   │   └── CHANGELOG.md   # Per-release notes
│   └── mcp/               # @billium/mcp — Model Context Protocol server
│       ├── src/           # Server + tool definitions
│       ├── tests/         # Vitest in-memory round-trip suite
│       └── README.md      # Host setup (Claude Code, Cursor, …)
└── .github/
    ├── workflows/         # CI + release automation
    ├── ISSUE_TEMPLATE/    # Bug + feature request forms
    └── CODEOWNERS         # Review requirements

開発

これは npm ワークスペースです。リポジトリのルートからスクリプトを実行してください。

npm install        # installs all workspace packages
npm run lint       # typechecks every package (src + tests)
npm test           # runs every package's test suite
npm run build      # builds every package

特定のパッケージで作業する場合は、cd packages/node && npm <script> を実行することもできます。

リリース

v*.*.* タグがプッシュされると、GitHub Actions によって npm にリリースが公開されます。

  1. packages/node/package.json#version と packages/node/src/version.ts#SDK_VERSION を新しいバージョンに更新します（CI で両者が一致していることを検証します）。
  2. 変更内容を説明するセクションを packages/node/CHANGELOG.md に追加します。
  3. main に更新をコミットします。
  4. タグを付けてプッシュします：git tag v1.0.1 && git push origin v1.0.1。
  5. リリースワークフローで lint、test、build が実行された後、provenance 付きで npm publish が実行されます。

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。