@bloomfilter/mcp服务器
MCP服务器 Bloomfilter，搜索和注册域名，并管理来自AI代理的DNS记录。
Bloomfilter是一个域注册和配置API，它使用 x402 支付。将您的人工智能代理指向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_config.json |
| 克劳德代码 | ~/.claude/settings.json |
| 光标 | .cursor/mcp.json |
| 帆板运动 | ~/.codeium/windsurf/mcp_config.json |
| VS代码+副本 | .vscode/mcp.json |
| 克莱恩 | 通过临床MCP设置UI |
| JetBrains集成开发环境 | 设置>工具>AI助手>MCP |
任何支持stdio服务器的MCP兼容客户端都可以工作。
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
BLOOMFILTER_PRIVATE_KEY | 用于付费操作 | - | EVM私钥（十六进制）。用于x402支付和基于钱包的身份验证。 |
BLOOMFILTER_API_URL | 没有 | https://api.bloomfilter.xyz | API基本URL |
如果没有私钥，只有 search_domains 和 get_pricing 工作。其他一切都需要一个钱包。
工具
服务器公开了10个工具：
免费（无需钱包）
search_domains: 检查域名是否可用并获取定价。一次搜索多个TLD。get_pricing: 获取一个或所有受支持顶级域名的注册、续订和转让定价。
已验证（需要钱包）
get_domain_info: 获取注册域的详细信息：状态、到期、名称服务器、锁定状态。register_domain: 注册一个新域名。通过x402自动使用美元支付。处理异步配置。renew_domain: 扩展域名注册。相同的x402支付流程。get_account: 查看钱包地址、域名计数、总支出。
DNS管理（需要钱包，每次突变0.10美元）
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调用时，服务器会自动处理付款协商：
- API通过HTTP 402和支付要求进行响应
- MCP服务器使用您的钱包签署USDC付款
- API验证付款并完成请求
所有付款均以美元支付（以太坊L2）。您的私钥对应的钱包中需要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+。
许可证
麻省理工学院