Findblock MCP

FindBlock MCP

MCP服务器，用于按时间戳检索块号，实现快速准确的链上数据查询。

特性

• 块时间戳搜索：使用可选的包容性查找特定时间戳之前/之后的块。
• 链发现：列出并检索数千个EVM链的详细信息。
• RPC代理：将JSON-RPC调用转发到任何链的最佳端点。

需求

• Python 3.10+
• 紫外线 用于依赖关系管理（推荐）

安装

1. 克隆和安装:

   git clone https://github.com/kukapay/findblock-mcp.git
   cd findblock-mcp
   uv sync 

1. 安装到Claude桌面：

将服务器安装为Claude Desktop应用程序：

   uv run mcp install main.py --name "Find Block"

配置文件作为参考：

   {
      "mcpServers": {
          "Find Block": {
              "command": "uv",
              "args": [ "--directory", "/path/to/findblock-mcp", "run", "main.py" ]
          }
      }
   }

将/path/to/findblock mcp替换为实际安装路径。

用法

安装后（例如，在Claude Desktop中），通过自然语言提示与工具进行交互。LLM将自动发现并调用它们。下面是详细的工具描述，包括参数和示例。

工具

1. find_block_before(chain_id: int, timestamp: int, inclusive: bool = False)

将块定位在紧邻之前（或，如果 inclusive=True)给定的UNIX时间戳。返回Markdown格式的块详细信息，包括数字、时间戳、哈希和父哈希。

参数:

• chain_id （int，必填）：EVM链ID。
• timestamp （int，必填）：UNIX时间戳（自纪元以来的秒数）。
• inclusive （bool，可选，default=False）：如果匹配，则在精确的时间戳处包含块。

示例提示:

查找2024年1月1日之前的最后一个以太坊区块。

期望输出:

### Block Details (Before Timestamp)
- **Number:** 19300000
- **Timestamp:** 1704067199 (UNIX)
- **Hash:** `0xabc123...def456`
- **Parent Hash:** `0xdef789...ghi012`

2. find_block_after(chain_id: int, timestamp: int, inclusive: bool = False)

在以下情况下立即定位块 inclusive=True)给定的UNIX时间戳。返回Markdown格式的块详细信息，包括数字、时间戳、哈希和父哈希。

参数:

• chain_id （int，必填）：EVM链ID。
• timestamp （int，必填）：UNIX时间戳（自纪元以来的秒数）。
• inclusive （bool，可选，default=False）：如果匹配，则在精确的时间戳处包含块。

示例提示:

2023年3月15日12:00 UTC之后的第一个多边形块是什么？

期望输出:

### Block Details (After Timestamp)
- **Number:** 45000000
- **Timestamp:** 1678867201 (UNIX)
- **Hash:** `0x123abc...456def`
- **Parent Hash:** `0x789ghi...012jkl`

3. list_chains()

检索FindBlock支持的所有可用EVM链的列表，格式为带有链名和ID的Markdown项目符号列表。

参数:

• 无

示例提示:

给我看一个我可以查询的流行EVM链列表。

期望输出:

### Available Chains

- **Ethereum** (Chain ID: 1)
- **Binance Smart Chain** (Chain ID: 56)
- **Polygon** (Chain ID: 137)
- **Avalanche C-Chain** (Chain ID: 43114)
- ... (truncated for brevity; full list includes 1,000+ chains)

4. get_chain(chain_id: int)

通过链ID获取特定EVM链的详细信息，该链ID以Markdown的形式返回，并带有名称和ID。

参数:

• chain_id （int，必填）：EVM链ID（例如，以太坊主网为1）。

示例提示:

告诉我以太坊主网的情况。

期望输出:

### Chain Details

- **Name:** Ethereum
- **Chain ID:** 1

5. rpc_call(chain_id: int, method: str, params: List[Any] = [], request_id: int = 1)

将EVM JSON-RPC请求代理到指定链的最佳性能RPC端点。支持任何标准EVM方法（例如。， eth_blockNumber, eth_getBalance).返回带有成功结果或错误详细信息的Markdown。

参数:

• chain_id （int，必填）：EVM链ID。
• method （str，必填）：JSON-RPC方法名称。
• params （List\[Any\]，可选，默认值=\[\]）：方法的参数数组。
• request_id （int，可选，默认=1）：请求的唯一ID。

示例提示:

币安智能链上的当前区块号是多少？

期望输出 （成功案例）：

### RPC Result

**ID:** 42
**Result:** 
"0x1a2b3c4d"

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。