Solidity MCP

Solidity MCP服务器

一个模型上下文协议服务器，通过聚合关键的以太坊学习资源，将Claude Code/Cline变成一个专注的Solidity导师。

先决条件

• Node.js 18+
• npm 9+（Node 18附带）
• 首次运行时访问Internet以获取文档源

1.克隆和安装

git clone  solidity-mcp
cd solidity-mcp
npm install

2.配置环境

复制示例环境文件并在需要时调整值：

cp .env.example .env

关键设置：

• CACHE_DIR –磁盘缓存所在的位置(./data/cache 默认情况下）
• CACHE_TTL –缓存寿命（毫秒）（默认24小时）
• MAX_CONCURRENT_REQUESTS / RATE_LIMIT_DELAY –调整刮刀礼貌

3.构建和运行

npm run build   # compile TypeScript to dist/
npm start       # launch the compiled MCP server

对于快速迭代，您可以使用：

npm run dev     # runs src/index.ts via tsx with live reload

4.可选：烟雾测试

npm run test    # exercises scrapers and service plumbing (requires network access)

5.添加到临床MCP中

更新您的Cline配置（例如。 ~/.cline/config.json)使用新服务器：

{
  "mcp": {
    "servers": {
      "solidity-mcp": {
        "command": "node",
        "args": ["/absolute/path/to/solidity-mcp/dist/index.js"],
        "cwd": "/absolute/path/to/solidity-mcp",
        "env": {
          "CACHE_DIR": "/absolute/path/to/solidity-mcp/data/cache",
          "LOG_LEVEL": "info"
        }
      }
    }
  }
}

一定要更换 /absolute/path/to/solidity-mcp 根据您机器上的实际位置。

6.使用技巧

• 使用 search_solidity_knowledge_base 混合结果。服务器现在将索引目录与实时抓取查找相结合，因此即使是模糊查询也往往会显示一些有用的东西。
• 合并 get_solidity_code_examples 和 get_solidity_reference 当解释一个新概念时。
• 跑 get_source_overview 要审计哪些集合被缓存，查看类型细分，并在深入研究之前发现高信号标签。
• 跑 refresh_content_cache 如果上游文档已经更改或结果感觉过时。

7.更新

npm run build
npm start

更改代码后，重建并重新启动MCP服务器，然后从Cline重新连接。

______________________________________________________________________

需要帮助？检查 solidity-mcp-setup.md 以获得更深入的演练。