bluepagesdoteth/bluepages-mcp
GitHub: bluepagesdoteth/bluepages-mcp
为 Bluepages.fyi 提供 MCP 接口的加密货币地址与社交媒体身份映射查询工具。
Stars: 1 | Forks: 0
# Bluepages MCP Server
用于 [Bluepages](https://bluepages.fyi) 的 [MCP](https://modelcontextprotocol.io) 服务器 — 加密货币地址与 Twitter/Farcaster 身份查询。
超过 800,000 条已验证的 Ethereum 地址与 Twitter/X 的映射关系，以及 Farcaster 用户名和显示名称。
## 快速开始
```
npx -y github:bluepagesdoteth/bluepages-mcp
```
需要满足以下任一条件：
- `BLUEPAGES_API_KEY` — 可在 [bluepages.fyi/api-keys](https://bluepages.fyi/api-keys.html) 获取（推荐，便宜 20%）
- `PRIVATE_KEY` — 用于 x402 按次付费的 Ethereum 私钥（Base 网络上的 USDC）
## 设置
添加到你的 MCP 客户端配置中（关于各客户端的配置文件位置，请参阅 [MCP 客户端](https://modelcontextprotocol.io/clients)）：
```
{
"mcpServers": {
"bluepages": {
"command": "npx",
"args": ["-y", "github:bluepagesdoteth/bluepages-mcp"],
"env": {
"BLUEPAGES_API_KEY": "your_key_here",
"PRIVATE_KEY": "your_eth_private_key_here"
}
}
}
}
```
**Claude Code** 用户：请改为[安装插件](https://github.com/bluepagesdoteth/agent-plugins) — 无需手动配置。
## 工具
| 工具 | 费用 | 描述 |
| -------------------------- | --------------------- | -------------------------------------------------- |
| `check_address` | 1 credit ($0.001) | 检查地址是否有数据 |
| `check_twitter` | 1 credit ($0.001) | 检查 Twitter 账号是否有数据 |
| `get_data_for_address` | 50 credits ($0.05) | 获取地址的完整身份数据（未找到则免费） |
| `get_data_for_twitter` | 50 credits ($0.05) | 获取 Twitter 账号的完整身份数据（未找到则免费） |
| `batch_check` | 40 credits ($0.04) | 最多检查 50 个项目 |
| `batch_get_data` | 40 credits/找到的项目 | 最多获取 50 个项目的数据（x402：每批次固定 $2.00） |
| `batch_check_streaming` | 同 batch_check | 适用于大型列表（100+），显示进度 |
| `batch_get_data_streaming` | 同 batch_get_data | 适用于大型列表（100+），显示进度 |
| `check_credits` | 免费 | 检查剩余 credits（仅限 API key） |
| `set_credit_alert` | 免费 | 设置低 credit 警告阈值（仅限 API key） |
| `get_api_key` | 免费 | 通过签名消息获取/创建 API key（PRIVATE_KEY） |
| `purchase_credits` | $5-$600 USDC | 通过 x402 购买 credits（仅限 PRIVATE_KEY） |
## 许可证
MIT
标签：API集成, MCP, MITM代理, Web3, 以太坊, 区块链, 可观测性, 自定义脚本, 身份查询