
Linea MCP Server

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 名称
适用场景
- 去中心化金融管理:
- 检查流动性池收益
- 交换代币
-
桥接资产到以太坊主网
-
NFT 艺术家和收藏家:
- 铸造新 NFT 集合
- 跟踪版税支付
-
转移艺术品给买家
-
身份验证(PoH):
- 验证身份用于 DeFi 协议
- 参与全民基本收入
- 为其他社区成员担保
工具列表
钱包工具
wallet_getAddress
:获取钱包地址wallet_listBalances
:列出钱包余额wallet_transferFunds
:转账资金到另一个地址
代币工具
tokens_erc20Balance
:检查 ERC20 代币余额tokens_erc20Transfer
:转移 ERC20 代币
合约工具
contracts_callContract
:调用合约函数contracts_deployContract
:部署智能合约
NFT 工具
nft_listNfts
:列出地址拥有的 NFTnft_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 记录(电子邮件、网站、社交媒体等)
常见问题解答
- "Cursor 中没有可用工具":
- 确保 MCP 配置文件格式正确
- 检查 Node.js 是否安装并可访问
-
验证项目路径是否正确
-
"客户端关闭"错误:
- 检查 MCP 服务器日志中的错误
- 确保环境变量设置正确
- 尝试重启 Cursor
-
检查配置 JSON 中是否有语法错误
-
连接问题:
- 验证 RPC 端点是否可访问
- 检查防火墙设置
使用教程
使用依赖
- 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
调试方式
- 检查服务器日志是否有错误
- 验证 RPC 端点是否可访问
- 测试基本功能如获取钱包地址
- 检查环境变量是否正确设置