Linea MCP Server

Linea MCP 服务

一个模型上下文协议（MCP）服务，为 AI 应用提供链上工具，以便与 Linea 区块链交互。

概览

Linea-MCP 为任意 MCP 客户端扩展功能，提供与 Linea 区块链交互的工具。Linea 是一种采用零知识证明技术的以太坊 Layer 2 扩容方案。此服务使 Claude、Cursor 等 AI 助手及其他兼容 MCP 的客户端能够通过自然语言请求执行区块链操作。

主要功能

• 钱包管理：获取地址并查询余额
• 代币操作：转移 ERC20 代币、查询余额、列出代币
• 智能合约交互：部署和调用合约
• NFT 管理：列出和转移 NFT
• 跨桥操作：在以太坊和 Linea 之间跨链转移资产
• DeFi 集成：与 DeFi 协议交互
• Verax 集成：使用 Linea Verax 证明验证身份
• Linea ENS：解析和管理 Linea ENS 名称

查看 examples.md，了解详细用法示例。

快速开始

前置条件

• Node.js（v16+）
• npm 或 yarn
• 可访问 Linea RPC 端点

安装选项

选项 1：快速安装（全局包）

# Install globally
npm install -g linea-mcp

# Create a basic .env file
echo "LINEA_MAINNET_RPC_URL=https://rpc.linea.build
LINEA_TESTNET_RPC_URL=https://rpc.sepolia.linea.build
WALLET_PRIVATE_KEY=your_wallet_private_key_here
INFURA_API_KEY=your_infura_key_here" > .env

# Start the server
linea-mcp

选项 2：开发安装（从源代码安装）

# Clone the repository
git clone https://github.com/qvkare/linea-mcp.git
cd linea-mcp

# Install dependencies
npm install

# Configure environment
cp .env.example .env
# Edit .env with your configuration

# Build and start
npm run build
node dist/index.js  # Using Node directly is more reliable than npm start

与 MCP 客户端集成

此 MCP 服务可与任何兼容 MCP 的客户端集成，包括 Cursor、Claude Desktop、Windsurf、Cline 和其他 AI 助手。

通用配置步骤

1. 找到客户端的 MCP 配置文件
2. 添加 Linea MCP 服务配置部分
3. 使用以下任一方式配置服务：

选项 1：使用全局安装（简单）

{
  "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"
      }
    }
  }
}

选项 2：使用本地安装（推荐用于开发）

{
  "mcpServers": {
    "linea": {
      "command": "node",
      "args": ["/absolute/path/to/linea-mcp/dist/index.js"],
      "cwd": "/absolute/path/to/linea-mcp",
      "env": {
        // Same environment variables as Option 1
        "PORT": "3000",
        "LINEA_MAINNET_RPC_URL": "https://rpc.linea.build",
        // ... other variables from Option 1
      }
    }
  }
}

重要提示：使用本地安装时，直接使用 Node.js 运行 JavaScript 文件，比使用 npm 脚本更可靠地进行通信。

特定客户端的配置位置

• Cursor：

  • Windows：%APPDATA%\Cursor\mcp.json
  • macOS：~/Library/Application Support/Cursor/mcp.json
  • Linux：~/.config/Cursor/mcp.json

• Claude Desktop：

  • Windows：%APPDATA%\Claude\claude_desktop_config.json
  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux：~/.config/Claude/claude_desktop_config.json

• 其他客户端：请参阅客户端文档，了解 MCP 配置文件的位置

故障排除

常见问题

1. “No tools available”或“Client closed”错误：

   • 使用 Node.js 直接执行（"command": "node", "args": ["/path/to/dist/index.js"]），不要使用 npm 脚本
   • 确保正确配置环境变量
   • 更改配置后重启客户端

2. 日志中出现 JSON 解析错误：

   • 这表明存在通信协议问题
   • 通常可通过直接使用 Node.js 执行来解决
   • 确保正确设置 cwd 属性

3. 完整的故障排除指南：

   • 查看 docs/troubleshooting.md，获取常见问题的详细解决方案

可用工具

服务器提供多个类别的工具：

• 钱包：地址管理、余额查询、资金转账
• 代币：ERC20 转账、余额查询、代币信息
• 合约：部署与交互
• NFT：列出与转账
• 跨链桥：在 Ethereum 和 Linea 之间跨链转移资产
• DeFi：流动性池、代币兑换、收益耕作
• ENS：名称解析与记录管理
• Verax：身份验证

如需查看完整工具列表及其用法，请参阅 docs/tools.md。

安全注意事项

• 切勿分享私钥或助记词
• 使用环境变量配置敏感信息
• 在主网使用前，先在测试网上充分测试

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。