Linea MCP Server

Linea MCP Server

site icon
2025.04.15 2
TypeScript区块链服务AI 交互工具金融服务
Linea MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,为 AI 应用提供与 Linea 区块链交互的工具。Linea 是一个采用零知识证明技术的以太坊 Layer 2 扩展解决方案。该服务器使 AI 助手(如 Claude 和 Cursor)能够通过自然语言请求执行区块链操作。
View on GitHub

Overview

基本能力

产品定位

Linea MCP Server 是一个为 AI 应用提供区块链交互能力的中间件,专注于 Linea 区块链上的各种操作。

核心功能

  • 钱包管理:获取地址和检查余额
  • 代币操作:转移 ERC20 代币和检查余额
  • 智能合约交互:部署和与合约交互
  • NFT 管理:列出和转移 NFT
  • 桥接操作:在以太坊和 Linea 之间桥接资产
  • DeFi 集成:与 Linea 上的 DeFi 协议交互
  • 人类证明:验证和管理 PoH 注册
  • Linea ENS:解析和管理 Linea ENS 名称

适用场景

  1. 去中心化金融管理
  2. 检查流动性池收益
  3. 交换代币
  4. 桥接资产到以太坊主网

  5. NFT 艺术家和收藏家

  6. 铸造新 NFT 集合
  7. 跟踪版税支付
  8. 转移艺术品给买家

  9. 身份验证(PoH)

  10. 验证身份用于 DeFi 协议
  11. 参与全民基本收入
  12. 为其他社区成员担保

工具列表

钱包工具

  • wallet_getAddress:获取钱包地址
  • wallet_listBalances:列出钱包余额
  • wallet_transferFunds:转账资金到另一个地址

代币工具

  • tokens_erc20Balance:检查 ERC20 代币余额
  • tokens_erc20Transfer:转移 ERC20 代币

合约工具

  • contracts_callContract:调用合约函数
  • contracts_deployContract:部署智能合约

NFT 工具

  • nft_listNfts:列出地址拥有的 NFT
  • nft_transferNft:转移 NFT

桥接工具

  • bridge_bridgeAssets:在以太坊和 Linea 之间桥接资产
  • bridge_bridgeStatus:检查桥接交易状态

DeFi 工具

  • defi_liquidityPools:获取流动性池信息
  • defi_swapTokens:在 DEX 上交换代币

PoH 工具

  • poh_verifyRegistration:验证 PoH 注册状态
  • poh_checkVouching:检查担保状态和历史
  • poh_listRegistrations:列出地址的所有 PoH 注册
  • poh_getVouchingPeriod:获取当前担保周期信息

ENS 工具

  • ens_resolveName:解析 ENS 名称到地址
  • ens_lookupAddress:查找地址的 ENS 名称
  • ens_checkNameAvailability:检查 ENS 名称是否可用
  • ens_getRecords:获取 ENS 记录(电子邮件、网站、社交媒体等)

常见问题解答

  1. "Cursor 中没有可用工具"
  2. 确保 MCP 配置文件格式正确
  3. 检查 Node.js 是否安装并可访问
  4. 验证项目路径是否正确

  5. "客户端关闭"错误

  6. 检查 MCP 服务器日志中的错误
  7. 确保环境变量设置正确
  8. 尝试重启 Cursor
  9. 检查配置 JSON 中是否有语法错误

  10. 连接问题

  11. 验证 RPC 端点是否可访问
  12. 检查防火墙设置

使用教程

使用依赖

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

安装教程

选项 1:全局安装(推荐大多数用户)

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

# 创建 .env 文件
cat > .env << EOL
# 网络配置
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
WALLET_PRIVATE_KEY=your_private_key_here_or_mnemonic
PORT=3000
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
EOL

# 启动 MCP 服务器
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

# 启动 MCP 服务器
npm start

调试方式

  1. 检查服务器日志是否有错误
  2. 验证 RPC 端点是否可访问
  3. 测试基本功能如获取钱包地址
  4. 检查环境变量是否正确设置

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。