MCP Smart Contract Analyst / 智能合约分析器

@author Ry @RockRockDay

Implements a Model Context Protocol (MCP) server to interact with the Monad blockchain for smart contract source code analysis, including functionality and security evaluation.

实现了一个 Model Context Protocol (MCP) 服务器，用于与 Monad 区块链交互，进行智能合约源代码的功能性与安全性分析。

For unverified contracts, decompilation is used to assist in source code recovery and review.

对于未验证的合约，将尝试进行反编译以辅助恢复和审查源代码。

What is MCP? / 什么是 MCP？

The Model Context Protocol (MCP) is a standard that allows AI models to interact with external tools and services.

Model Context Protocol（模型上下文协议，简称 MCP）是一种标准，允许 AI 模型与外部工具和服务进行交互。

Prerequisites

• Node.js (v16 or later)
• npm or yarn
• Claude Desktop / Cursor ide / more…

Getting Started

1. Clone this repository

git clone https://github.com/rockyuan/mcp-contract-analyst.git

2. Install dependencies:

npm install

3. Build the project

npm run build

The server is now ready to use!

Adding the MCP server to Cursor

1. Open “Cursor”.

2. Open Settings.

Cursor > Settings > Cursor Settings > MCP

3. Click “Add a new global MCP server”.

4. Add details about the MCP server and save the file.

{
  "mcpServers": {
    "mcp-contract-analyst": {
      "command": "node",
      "args": ["/<path-to-project>/build/index.js"],
      "env": {
        "API_URL": "https://api.blockvision.org/v2/monad/contract/source/code?address=",
        "API_KEY": "xxxxxxxxxxx",
        "DECOMPILE_URL": "https://www.ethervm.io/decompile"
      }
    }
  }
}

5. Refresh Cursor.

Using the MCP server

Adding the MCP server to Claude Desktop

1. Open “Claude Desktop”

2. Open Settings

Claude > Settings > Developer

3. Open claude_desktop_config.json

4. Add details about the MCP server and save the file.

{
  "mcpServers": {
    "mcp-contract-analyst": {
      "command": "node",
      "args": ["/<path-to-project>/build/index.js"],
      "env": {
        "API_URL": "https://api.blockvision.org/v2/monad/contract/source/code?address=",
        "API_KEY": "xxxxxxxxxxx",
        "DECOMPILE_URL": "https://www.ethervm.io/decompile"
      }
    }
  }
}

5. Restart “Claude Desktop”

Further Resources

• Model Context Protocol Documentation
• Monad Documentation
• Viem Documentation
• Monad MCP Tutorial

Thanks

• Monad Developers