bloomfilter

本地服务

github.com/BloomFilter-Labs云与基础设施1035 周前更新

代码仓库

关于 bloomfilter

bloomfilter 是供 AI Agent 通过 Bloomfilter API 搜索和注册域名、管理 DNS 的 MCP 服务。付费操作使用配置的钱包，通过 x402 以 USDC 支付。

主要功能

01查询域名可用性与价格
02注册和续费域名
03查看域名状态与账户
04管理 DNS 记录
05通过 x402 支付 USDC

适用场景

01查询多个域名后缀的可用性
02由 Agent 注册或续费域名
03查看域名到期时间和名称服务器
04添加或编辑 DNS 记录

MCP 相关

它通过 stdio 向 MCP 客户端提供 Bloomfilter 域名和 DNS 操作工具。查询和价格功能无需钱包，其他操作需要配置私钥。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "eronmmer-bloomfilter": {
      "command": "npx",
      "args": [
        "-y",
        "@bloomfilter/mcp-server"
      ],
      "env": {
        "BLOOMFILTER_PRIVATE_KEY": "<BLOOMFILTER_PRIVATE_KEY>",
        "BLOOMFILTER_API_URL": "<BLOOMFILTER_API_URL>",
        "BLOOMFILTER_NETWORK": "<BLOOMFILTER_NETWORK>"
      }
    }
  }
}

启动命令npx -y @bloomfilter/mcp-server

需要配置的环境变量

BLOOMFILTER_PRIVATE_KEY密钥Hex-encoded private key for a wallet funded with USDC on Base to pay for domains and DNS operations

BLOOMFILTER_API_URLBloomfilter API base URL (defaults to https://api.bloomfilter.xyz)

BLOOMFILTER_NETWORKCAIP-2 network identifier (defaults to eip155:8453 / Base mainnet)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@bloomfilter/mcp-server0.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@bloomfilter/mcp-server

面向 Bloomfilter 的 MCP 服务，供 AI Agent 搜索和注册域名，以及管理 DNS 记录。

Bloomfilter 是一个域名注册和配置 API，使用 x402 进行支付。将 AI Agent 接入 Bloomfilter API，为其提供一个含有 USDC 的钱包，它便能自主搜索、注册和配置域名。

无需登录，无需信用卡，也无需仪表板。只需 HTTP 请求和加密货币钱包。

此 MCP 服务封装了 Bloomfilter API，因此任何兼容 MCP 的客户端（Claude Desktop、Cursor、Windsurf、自定义 Agent 等）都可以将其用作工具提供方。

快速开始

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 设置界面
JetBrains IDEs	设置 > 工具 > AI Assistant > MCP

任何支持 stdio 服务的 MCP 兼容客户端都可以使用。

环境变量

变量	必需条件	默认值	描述
`BLOOMFILTER_PRIVATE_KEY`	付费操作时必需	-	EVM 私钥（十六进制）。用于 x402 支付和基于钱包的身份验证。
`BLOOMFILTER_API_URL`	否	`https://api.bloomfilter.xyz`	API 基础 URL。

如果没有私钥，则只能使用 search_domains 和 get_pricing。其他所有功能都需要钱包。

工具

该服务提供 10 个工具：

免费（无需钱包）

search_domains： 检查域名是否可用并获取价格。一次搜索多个顶级域名。
get_pricing： 获取一个或所有受支持顶级域名的注册、续费和转移价格。

需要身份验证（需钱包）

get_domain_info： 获取已注册域名的详细信息：状态、到期时间、域名服务器和锁定状态。
register_domain： 注册新域名。通过 x402 自动使用 USDC 支付，并处理异步配置。
renew_domain： 延长域名注册期限。使用相同的 x402 支付流程。
get_account： 查看钱包地址、域名数量和总支出。

DNS 管理（需要钱包，每次修改需支付 $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 protocol，这是一种原生于 HTTP 的支付标准。当工具触发付费 API 调用时，服务会自动处理支付协商：

API 返回 HTTP 402 和支付要求
MCP 服务使用你的钱包签署 USDC 支付
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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。