shield_lock
金大哥
← 返回 MCP 目录
public公开dns本地运行

linea-mcp

Linea MCP是一个为AI应用提供与Linea区块链交互工具的服务器，支持钱包管理、代币操作、智能合约交互等功能，兼容多种MCP客户端。

article

README

🚀 线 MCP 服务器

一个提供链上工具的模型上下文协议（MCP）服务器，可助力 AI 应用程序与 Linea 区块链实现交互，为区块链操作带来便捷。

npm 版本 许可证: MIT

🚀 快速开始

线 - MCP 服务器让 AI 助手能通过自然语言请求执行区块链操作。下面为您介绍快速上手的步骤：

  1. 安装：使用 npm 安装线 - MCP。
  2. 配置：编辑配置文件以设置 API 密钥和助记词。
  3. 启动：运行服务器并在指定网络上进行交互。

✨ 主要特性

线 - MCP 扩展了任何 MCP 客户端的功能，使其能够与 Linea 区块链交互。Linea 是一个使用零知识证明技术的以太坊 Layer 2 扩展解决方案。此服务器让像 Claude、Cursor 和其他 MCP 兼容客户端这样的 AI 助手，可通过自然语言请求执行区块链操作，支持多种区块链操作，包括钱包管理、代币转移、智能合约部署等。

📦 安装指南

快速安装

npm install -g linea-mcp

环境变量配置

编辑 ~/.config/linea-mcp/config.json 文件：

{
  "etherscanApiKey": "your_etherscan_api_key",
  "mnemonic": "your_mnemonic_phrase"
}

💻 使用示例

基础用法

初始化服务器

linea-mcp init

启动服务器

linea-mcp start --network <NETWORK> [--port <PORT>]

常用命令

linea-mcp balance <ADDRESS>
linea-mcp transfer <TO_ADDRESS> <AMOUNT>
linea-mcp contract deploy <CONTRACT_PATH>

配置示例

config.json

{
  "network": "mainnet",
  "etherscanApiKey": "Your_Etherscan_API_Key",
  "mnemonic": "your mnemonic phrase"
}

常用命令说明

| 命令 | 描述 | |-----------------------|-----------------------------------| | linea-mcp init | 初始化服务器 | | linea-mcp start | 启动服务器 | | linea-mcp balance | 查询地址余额 | | linea-mcp transfer | 发送以太坊或代币 | | linea-mcp contract | 部署和交互智能合约 |

📚 详细文档

文档资源

🔧 技术细节

项目结构

linea-mcp/
├── src/          # 核心源代码
│   ├── wallet.js    # 钱包相关功能
│   ├── token.js     # 代币相关功能
│   └── contract.js  # 智能合约功能
├── config.json      # 服务器配置文件
└── package.json     # 项目依赖和脚本

开发步骤

  1. 克隆仓库：
git clone https://github.com/linea-mcp/linea-mcp.git
cd linea-mcp
  1. 安装依赖：
npm install
  1. 开始开发：
npm run dev

贡献指南

  • 提交代码前，请确保通过所有测试。
  • 遵循代码规范。

📄 许可证

此项目遵循 MIT 许可证，详情请见 LICENSE 文件。

⚠️ 重要提示

  • 私钥管理：从不分享您的私钥或助记词。
  • 环境变量：使用环境变量存储敏感配置信息。
  • 测试：在主网上线之前，先在测试网络上进行彻底测试。
  • 隐私保护：避免在不安全的网络中传输敏感信息。
  • 权限管理：限制服务访问不必要的端口和网络资源。
即贴即用配置

MCP 客户端配置生成器

选择客户端，补齐所需环境变量，再复制根据当前 MCP 公开配置生成的完整文件

terminal
环境变量lock填写内容仅保留在当前浏览器标签页，不会上传或保存
Claude Desktop
{
  "mcpServers": {
    "linea": {
      "command": "npx",
      "args": [
        "linea-mcp@latest"
      ],
      "env": {
        "PORT": "3000",
        "LINEA_MAINNET_RPC_URL": "https://rpc.linea.build",
        "LINEA_TESTNET_RPC_URL": "https://rpc.sepolia.linea.build",
        "INFURA_API_KEY": "your_infura_key",
        "ALCHEMY_API_KEY": "your_alchemy_key",
        "PRIVATE_KEY_ENCRYPTION_KEY": "your_encryption_key_please_change",
        "WALLET_PRIVATE_KEY": "your_wallet_private_key_or_mnemonic",
        "NODE_ENV": "development",
        "ETHEREUM_RPC_URL": "https://mainnet.infura.io/v3/your_infura_key",
        "ETHEREUM_TESTNET_RPC_URL": "https://sepolia.infura.io/v3/your_infura_key"
      }
    }
  }
}
建议保存到claude_desktop_config.json
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载，用户一般按页面提供的连接方式或授权流程接入，不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖，把 server_config 复制到 MCP 客户端，并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端