Eth Security MCP

🚀 ETH 安全 MCP

ETH 安全 MCP 是一個為安全分析師、審計員和事件響應人員收集的 MCP 服務器，可助力相關人員更高效地開展工作。

🚀 快速開始

📦 安裝指南

依賴項

eth-security-mcp 需要以下依賴項已安裝：

• node 和 npm
• just

環境變量設置

eth-security-mcp 中的 MCP 服務器可能會使用環境變量來傳遞信息，例如 API 密鑰。.env.example 列出了運行所有 MCP 服務器所需的相關值。要設置 .env 文件，請運行 cp .env.example .env 並填寫相關信息。

工作區

此倉庫使用 npm 工作區將每個操作分開。要與特定的工作區交互，請使用 npm <action> -w src/<directory-name>。

構建和調試

此 repo 使用 justfile 來自動化構建和調試，使用的是 MCP Inspector。例如，要構建並調試 dune MCP 服務器，可以運行以下命令：

$ just -l
Available recipes:
    build workspace
    debug workspace

$ just debug dune

將 MCP 服務器安裝到 Claude Desktop

要將此倉庫中的 MCP 服務器安裝到 Claude Desktop 中：

1. 運行 just setup-<machine> <mcp-server>，其中 <machine> 要麼是 linux 要麼是 macos，而 <mcp-server> 是包含 MCP 服務器的目錄名稱。
2. 此 just 命令將在 MCP 服務器目錄中生成一個文件 claude.config.tmp.json，可以將其複製粘貼到以下文件中的 mcpServers 下：
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • linux: ~/.config/Claude/claude_desktop_config.json
3. 添加配置信息後，重啟 Claude Desktop 以使更改生效。

💻 使用示例

Dune MCP 服務器

基礎用法

# 示例命令，使用 Dune MCP 服務器獲取地址的交易
# 這裡假設要獲取地址為 0xabc123 的交易
$ just debug dune
# 調用 get_transactions_by_address 工具
# 假設使用默認參數，僅傳入必填的 address 參數
# 實際使用時根據需要添加可選參數
# 這裡只是示意，具體調用方式可能因環境而異

高級用法

# 高級場景：獲取地址為 0xabc123 的交易，同時篩選鏈 ID 為 1、2，限制返回交易數量為 10
# 調用 get_transactions_by_address 工具並傳入相關參數
# 這裡只是示意，具體調用方式可能因環境而異
$ just debug dune
# 調用 get_transactions_by_address 工具
# 傳入 address、chain_ids 和 limit 參數
# 實際使用時根據需要添加其他可選參數

Cast MCP 服務器

基礎用法

# 示例命令，使用 Cast MCP 服務器模擬事務
# 假設要模擬事務哈希為 0xdef456 的事務
# 假設使用的 Ethereum 節點的 RPC URL 為 http://example.com/rpc
$ just debug cast
# 調用 run_transaction 工具
# 傳入 transactionHash 和 rpcUrl 參數
# 這裡只是示意，具體調用方式可能因環境而異

高級用法

# 高級場景：使用快速模式模擬事務哈希為 0xdef456 的事務
# 假設使用的 Ethereum 節點的 RPC URL 為 http://example.com/rpc
$ just debug cast
# 調用 run_transaction 工具
# 傳入 transactionHash、rpcUrl 和 quick 參數
# 這裡只是示意，具體調用方式可能因環境而異

📚 詳細文檔

MCP 服務器

Dune

Dune MCP 服務器提供對 Dune API 端點的訪問，返回結構化的交易結果。

可用工具

get_transactions_by_address

• 概述：使用 Dune 的 Echo API 獲取地址的交易。
• 參數
  • address (必填)：要獲取交易的地址。
  • chain_ids (可選)：逗號分隔的鏈 ID 列表，用於篩選交易。
  • method_id (可選)：過濾交易以返回具有提供的方法 ID（函數選擇器）的交易。
  • log_address (可選)：過濾交易以返回日誌中包含該地址的交易。
  • topic0 (可選)：過濾交易以返回具有提供的主要事件主題的交易。
  • min_block_number (可選)：過濾交易以返回從該塊編號開始及之後的交易。
  • limit (可選)：限制返回的交易數量。
  • is_sender (可選)：返回發送方為提供的地址的交易。
  • is_receiver (可選)：返回接收方為提供地址的交易。
• 返回 返回一個交易對象數組，每個交易包含以下相關信息：
  • address：合約或賬戶涉及的地址。
  • block_number：包含交易的塊編號。
  • data：事務數據。
  • from：事務發送方地址。
  • gas_used：使用的氣數。
  • to：事務接收方地址（如果是合約創建，則為 null）。
  • value：轉移的 ETH 數量，以 wei 為單位。
  • receipt：交易收據，包含 gas 使用情況、狀態等信息。

Cast

Cast MCP 服務器提供對 Foundry 的 cast 命令行工具的訪問，允許與 Ethereum 節點和智能合約交互。

可用工具

run_transaction

• 概述：使用 Foundry 的 cast 運行命令模擬事務。
• 參數
  • transactionHash (必填)：要模擬的事務哈希。
  • rpcUrl (必填)：用於模擬的 Ethereum 節點的 RPC URL。
  • quick (可選)：是否使用快速模式以加快模擬（默認：false）。
• 返回 返回模擬結果作為字符串，包括：
  • 事務執行詳細信息。
  • 狀態更改。
  • 氣體使用情況。
  • 任何重置原因（如果有）。