bloomfilter

@bloomfilter/mcp-server

Bloomfilter 用の MCP サーバーです。AI エージェントからドメイン名を検索・登録し、DNS レコードを管理できます。

Bloomfilter は、決済に x402 を使用するドメイン登録・設定 API です。AI エージェントから Bloomfilter API に接続し、USDC を入れたウォレットを渡すと、エージェントが自律的にドメインを検索、登録、設定できます。

ログイン、クレジットカード、ダッシュボードは不要です。HTTP リクエストと暗号資産ウォレットだけで利用できます。

この MCP サーバーは Bloomfilter API をラップしており、MCP 対応クライアント（Claude Desktop、Cursor、Windsurf、カスタムエージェントなど）からツールプロバイダーとして利用できます。

クイックスタート

BLOOMFILTER_PRIVATE_KEY=0x... npx @bloomfilter/mcp-server

サーバーは stdio（JSON-RPC）で通信します。単独で実行するのではなく、MCP クライアントから起動することを想定しています。

設定

次の JSON を MCP クライアントの設定ファイルに追加してください。

{
	"mcpServers": {
		"bloomfilter": {
			"command": "npx",
			"args": ["-y", "@bloomfilter/mcp-server"],
			"env": {
				"BLOOMFILTER_PRIVATE_KEY": "0x..."
			}
		}
	}
}

クライアント別の設定ファイルの場所

クライアント	設定ファイル
Claude Desktop	claude_desktop_config.json
Claude Code	~/.claude/settings.json
Cursor	.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code + Copilot	.vscode/mcp.json
Cline	Cline の MCP 設定 UI 経由
JetBrains IDEs	設定 > ツール > AI Assistant > MCP

stdio サーバーに対応する MCP クライアントであれば、どれでも利用できます。

環境変数

変数	必須	デフォルト	説明
BLOOMFILTER_PRIVATE_KEY	有料操作の場合は必須	-	EVM の秘密鍵（16 進数）。x402 決済とウォレットベースの認証に使用します。
BLOOMFILTER_API_URL	いいえ	https://api.bloomfilter.xyz	API のベース URL。

秘密鍵がない場合は、search_domains と get_pricing のみ利用できます。それ以外の操作にはウォレットが必要です。

ツール

このサーバーは 10 個のツールを公開します。

無料（ウォレット不要）

• search_domains: ドメインが利用可能かどうかを確認し、料金を取得します。複数の TLD を一度に検索できます。
• get_pricing: 1 つまたはすべての対応 TLD の登録、更新、移管料金を取得します。

認証が必要（ウォレット必須）

• get_domain_info: 登録済みドメインの詳細（ステータス、有効期限、ネームサーバー、ロック状態）を取得します。
• register_domain: 新しいドメインを登録します。x402 を介して USDC で自動的に支払います。非同期のプロビジョニングにも対応します。
• renew_domain: ドメイン登録の有効期間を延長します。同じ x402 決済フローを使用します。
• get_account: ウォレットアドレス、ドメイン数、合計利用額を確認します。

DNS 管理（ウォレットが必要です。変更1回につき $0.10 USDC）

• list_dns_records: ドメインのすべての DNS レコードを一覧表示します。
• add_dns_record: DNS レコード（A、AAAA、CNAME、MX、TXT、NS、SRV、CAA、FORWARD）を追加します。
• update_dns_record: ID を指定して既存の DNS レコードを更新します。
• delete_dns_record: ID を指定して DNS レコードを削除します。

支払いの仕組み

Bloomfilter は x402 プロトコルを使用しています。これは HTTP ネイティブの決済標準です。ツールが有料の API 呼び出しを実行すると、サーバーが自動的に支払いのネゴシエーションを処理します。

1. API が HTTP 402 と支払い要件を返します
2. MCP サーバーがウォレットを使って USDC の支払いに署名します
3. API が支払いを検証し、リクエストを完了します

すべての支払いは Base（Ethereum の L2）上の USDC で行われます。秘密鍵に対応するウォレットに USDC が必要です。

認証

サーバーは SIWE（Sign-In With Ethereum）を使用して Bloomfilter API に認証します。認証が必要なツールを初めて呼び出すと、自動的に認証が行われます。秘密鍵を指定する以外にセットアップは必要ありません。

ドキュメント

API リファレンスとガイドの全文は docs.bloomfilter.xyz をご覧ください。

ソースからのビルド

git clone https://github.com/BloomFilter-Labs/mcp-server-bloomfilter.git
cd mcp-server-bloomfilter
npm install
npm run build

Node.js 20 以降が必要です。

ライセンス

MIT