Solidity学习资源聚合服务

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

  • by 0xPier
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 0xPier/solidity-mcp

使用说明

Solidity MCP服务器

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

先决条件

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

1.克隆和安装

git clone <your-fork-or-repo-url> 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 以获得更深入的演练。