Back to MCP directory
publicPublicdnsLocal runtime

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 文件。

⚠️ 重要提示

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

MCP client config generator

Choose your client, fill the required environment variables, then copy a config generated from this server's published metadata

terminal
Environment variableslockValues stay in this browser tab and are not uploaded or saved
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"
      }
    }
  }
}
Save toclaude_desktop_config.json
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client