星战科技xingzhan.cloud
返回市场
线性-MCP服务器

线性-MCP服务器

作者：qvkare2 星标更新：2025-09-14
安装使用来源：spider==github.com

项目介绍

Linea MCP Server

<div align="center"> <img src="assets/logo.png" alt="Linea MCP Logo"> </div>

这是一个模型上下文协议（MCP）服务器，提供与Linea区块链交互的链上工具，适用于AI应用程序。

Ask DeepWiki npm version License: MIT

概述

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

主要特性

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

参见examples.md以获取详细的使用示例。

快速开始

先决条件

  • Node.js (v16+)
  • npm 或 yarn
  • 访问Linea RPC端点

安装选项

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

# 全局安装
npm install -g linea-mcp

# 创建基本的.env文件
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

# 启动服务器
linea-mcp

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

# 克隆仓库
git clone https://github.com/qvkare/linea-mcp.git
cd linea-mcp

# 安装依赖
npm install

# 配置环境
cp .env.example .env
# 使用您的配置编辑.env

# 构建并启动
npm run build
node dist/index.js  # 直接使用Node比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": {
        // 与选项1相同的环境变量
        "PORT": "3000",
        "LINEA_MAINNET_RPC_URL": "https://rpc.linea.build",
        // ... 来自选项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. “没有可用工具”或“客户端关闭”错误：

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

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

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

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

提供的工具

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

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

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

安全注意事项

  • 切勿分享您的私钥或助记词
  • 使用环境变量进行敏感配置
  • 在主网上使用之前，在测试网中进行广泛的测试

许可证

本项目根据MIT许可证发布 - 详情请参阅LICENSE文件。