Foundry MCP Rs

Foundry MCP服务器

一个模型上下文协议（MCP）服务器，通过统一的接口提供对所有Foundry CLI工具（锻造、铸造、砧座、凿子）的访问，以及区块链RPC发现和令牌信息。

特性

• 🛠️ 综合支持：完全访问所有Foundry命令、区块链RPC发现、令牌信息、会话管理和统一的转换工具——所有这些都在一个地方
• 🚀 快速：开销最小，外壳为原生Foundry二进制文件
• 📋 完全架构支持：处理位置、选项和标志
• 🔌 MCP协议：基于标准stdio的MCP服务器实现
• 🎯 会话管理：启动/停止Anvil节点和Chisel REPL会话作为后台进程
• 🌐 RPC发现：从chainlist.org查询2400多个区块链网络及其RPC端点
• 🔍 连锁搜索：按名称、符号或链ID查找网络
• 📊 网络信息：访问水龙头、浏览器和网络元数据
• 🪙 令牌信息：在以太坊和L2链上搜索和发现ERC20代币
• 🔎 代币搜索：按名称、符号或合约地址查找令牌
• 🌉 桥梁信息：访问跨链令牌桥信息
• 🔄 统一转换：用于所有转换操作（十六进制、十进制、基数、ETH单位、文本编码、RLP等）的单一工具
• 🔒 安全：可配置的禁止命令和标志，以防止危险操作

可用工具

铸造工具

• 锻造：构建、测试、脚本、验证、覆盖率、快照、初始化、配置等。
• 投射：呼叫、发送、接收、钱包、存储、解码、阻止、交易等。
• 铁砧：本地以太坊开发节点 _（交互式被阻止，请使用下面的会话工具）_
• 凿子 （6） ：Solidity REPL _（交互式被阻止，请使用下面的会话工具）_

会话管理工具（7）

Anvil会话管理 -控制后台Anvil实例：

• anvil_session_start -将Anvil作为后台进程启动（分叉、自定义端口、帐户、阻塞时间）
• anvil_session_stop -停止正在运行的Anvil实例
• anvil_session_status -检查Anvil是否正在运行并获取连接详细信息

Chisel会话管理 -带有状态的持久REPL：

• chisel_session_start -开始Chisel REPL会话
• chisel_session_eval -执行Solidity代码（状态在调用之间持续存在！）
• chisel_session_stop -停止Chisel会话
• chisel_session_status -检查凿子是否正在运行

区块链RPC工具（3）

search_rpc_url -搜索任何具有过滤功能的链的RPC端点（开源、无跟踪、websocket/http、限制）\ search_chains -按名称、符号或链ID搜索网络\ list_popular_chains -快速访问流行网络（以太坊、Polygon、Arbitrum等）

代币信息工具（4）

search_tokens -在所有支持的链中按名称或符号搜索令牌\ get_token_by_address -按合约地址获取代币信息\ list_chain_tokens -列出特定区块链网络上可用的所有代币\ list_supported_chains -列出令牌列表支持的所有区块链网络

支持的链条：

• 以太坊、乐观主义、Base、Sepolia（测试网）
• 乐观的Sepolia，基础Sepolia（测试网）
• Mode、Lisk、红石、Metal L2、Celo
• 更多的L2网络

安装

先决条件

Foundry必须在PATH中安装并可用：

curl -L https://foundry.paradigm.xyz | bash
foundryup

构建

cargo build --release

编译后的二进制文件将位于 ./target/release/foundry-mcp-server

用法

运行服务器

服务器使用MCP协议通过stdin/stdout进行通信：

foundry-mcp

Claude桌面配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

无配置（无限制）:

{
  "mcpServers": {
    "foundry": {
      "command": "/path/to/foundry-mcp-rs/target/release/foundry-mcp"
    }
  }
}

具有自定义配置:

{
  "mcpServers": {
    "foundry": {
      "command": "/path/to/foundry-mcp-rs/target/release/foundry-mcp",
      "args": ["--config", "/path/to/your/config.json"]
    }
  }
}

配置

服务器支持可配置的安全限制，以防止危险操作。当通过AI助手公开Foundry工具时，这一点尤为重要。

运作原理：在初始化过程中，禁止的命令和标志会从工具架构中过滤出来。这意味着AI助手甚至看不到这些工具/标志——它们根本不会出现在可用工具列表中。这比运行时验证更安全，因为它遵循最小特权原则。

配置源

服务器从以下位置加载配置：

1. CLI标志 --config path/to/config.json （显式路径）
2. 默认位置 在 ~/.foundry-mcp-config.json
3. 无限制 如果找不到配置

配置格式

{
  "forbidden_commands": ["anvil", "forge_script"],
  "forbidden_flags": ["broadcast", "private-key", "mnemonic"],
  "allow_dangerous": false
}

配置选项

• forbidden_commands：要阻止的命令名称数组（例如。， "anvil", "forge_script", "cast_send")
• forbidden_flags：要阻止的标志名称数组（例如。， "broadcast", "private-key", "mnemonic")
• allow_dangerous：布尔值，用于控制硬编码的危险限制

- false （默认）：自动将硬编码的危险命令/标志添加到禁止列表中 - true：仅使用您明确配置的禁止列表

硬编码危险限制

当 allow_dangerous: false （默认设置），以下硬编码限制是 自动地 与您的配置合并：

危险命令：

• anvil -本地以太坊节点

危险标志：

• broadcast -将交易发送到网络
• private-key -直接使用私钥
• mnemonic -直接使用助记符短语
• legacy -传统交易类型
• unlock -解锁帐户

注： 您的定制 forbidden_commands 和 forbidden_flags 与这些硬编码值合并，因此您可以添加额外的限制，而无需重复默认值。

用法示例

在默认安全限制下运行:

foundry-mcp

使用自定义配置运行:

foundry-mcp --config /path/to/config.json

将配置复制到默认位置 （更新系统默认值）：

cp config.safe.json ~/.foundry-mcp-config.json
foundry-mcp

显示帮助:

foundry-mcp --help

运作原理

1. 从以下位置加载Foundry CLI模式 schemas.json
2. 通过MCP公开170个Foundry工具+3个RPC发现工具+4个令牌信息工具+7个会话管理工具
3. 将shell输出到本机Foundry二进制文件以供执行
4. 管理Anvil和Chisel会话的后台流程
5. 从chainlist.org获取区块链RPC数据（缓存）
6. 从乐观令牌列表（缓存）中获取令牌信息

建筑

• 无铸造车间：外壳为本机二进制文件（避免800多个可传递的deps）
• 模块化：干净的分隔（foundry.rs、chainlist.rs、tokenlist.rs和server.rs）
• 缓存数据：用于chainlist.org和令牌列表API的内存缓存
• MCP资源:

- chainlist://all -2400+区块链网络数据库 - tokenlist://all -以太坊和L2链上的ERC20代币

许可证

麻省理工学院或Apache-2.0（与Foundry相同）

相关项目

• 铸造厂 -用于以太坊开发的快速、便携和模块化工具包
• 主控程序 -模型上下文协议规范
• rmcp -MCP官方Rust SDK