AI导哈

区块链AI交互服务器

Linea MCP Server是一个模型上下文协议服务器，为AI应用提供与Linea区块链交互的工具，支持钱包管理、代币操作、智能合约交互等功能。

  • by qvkare
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 qvkare/linea-mcp

使用说明

MCP 服务器

模型上下文协议（MCP）服务器，为AI应用程序提供链上工具，以与Linea区块链进行交互。

概述

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

主要特点

  • 钱包管理：检索地址并检查余额
  • 令牌操作：转移ERC20代币，检查余额，列出代币
  • 智能合约交互：部署和调用合同
  • NFT 管理：列出并转移NFT
  • 桥梁运营：以太坊和Linea之间的桥梁资产
  • DeFi集成：与DeFi协议交互
  • Verax集成：通过Linea Verax证明验证身份
  • ENS 线：解析和管理Linea ENS名称

参见示例.md 查看详细的使用示例。

快速开始

先决条件

  • Node.js（v16+）
  • npm或纱线
  • 访问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脚本提供更可靠的通信。

客户特定位置

  • 光标:

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

  • 克劳德桌面:

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

  • 其他客户：有关MCP配置位置，请参阅客户的文档

故障排除

常见问题

  1. “无可用工具”或“客户端已关闭”错误:

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

  2. 日志中的JSON解析错误:

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

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

可用工具

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

  • 钱包：地址管理、余额检查、资金转账
  • 代币：ERC20转账、余额检查、代币信息
  • 合同：部署和互动
  • NFT：上市和转让
  • 桥：以太坊和Linea之间的资产桥接
  • 定义：流动性池、代币互换、收益农业
  • ENS：名称解析和记录管理
  • 阳台：身份验证

有关工具及其用法的完整列表，请参阅 docs/tools.md.

安全考虑

  • 切勿共享您的私钥或种子短语
  • 使用环境变量进行敏感配置
  • 在主网上使用之前，使用测试网进行广泛测试

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP