Linea MCP 服务器

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

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

概述

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

主要特性

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

真实世界用例

1. 去中心化金融管理

想象一下，您是一位忙碌的专业人士，管理您的 DeFi 投资：

早上: "检查我隔夜的流动性池收益"
午餐: "将我一半的 USDC 收益兑换成 ETH"
晚上: "将我的 ETH 收益桥接到以太坊主网"

2. NFT 艺术家和收藏家

作为管理您的数字艺术的 NFT 创建者或收藏家：

- 铸造新的 NFT 系列
- 跟踪版税支付
- 将艺术品转移给买家
- 检查系列统计数据

3. 身份验证 (PoH)

使用人类证明进行各种应用：

- 验证 DeFi 协议的身份
- 参与全民基本收入
- 为其他社区成员担保
- 保持验证状态

有关更详细的用例和示例，请参见 examples.md。

快速示例

以下是一些常见的用法示例。 有关更详细的示例，请参见 examples.md。

钱包操作

用户: "我的钱包地址是什么？"
结果: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

用户: "显示我的钱包余额"
结果:
- ETH: 1.5 ETH
- USDC: 100 USDC

跨链桥操作

用户: "将 1 ETH 从以太坊桥接到 Linea"
步骤:
1. 启动桥接交易
2. 在以太坊上确认
3. 等待 Linea 上的确认

人类证明

用户: "验证我的 PoH 注册状态"
结果: 自 2024-03-15 起已验证

Linea ENS

用户: "解析 name.linea.eth"
结果: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

用户: "查找 0x8dF3e4806A3320D2642b1F2835ADDA1A40719c4E 的 ENS"
结果: qvkare.linea.eth

用户: "检查 randomname.linea 是否可用"
结果: 可用 - 此名称可以注册

用户: "获取 qvkare.linea.eth 的电子邮件和 Twitter 记录"
结果:
- 电子邮件: 未设置
- Twitter: 未设置

有关更多示例和详细的使用说明，请参阅我们的 examples.md 文件。

有关详细的 ENS 集成示例，请参见 docs/ens-usage.md。

当前状态

该项目目前正在开发中，已实现以下组件：

• ✅ 核心 MCP 服务器基础设施
• ✅ 钱包管理工具
• ✅ 代币操作
• ✅ 合约交互
• ✅ NFT 管理
• ✅ 跨链桥操作
• ✅ DeFi 集成
• ✅ PoH 验证系统
• ✅ Linea ENS 集成

所有工具都已成功被 MCP 服务器发现，但某些 MCP 客户端可能存在兼容性问题。

快速开始

前提条件

• 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

与 MCP 客户端集成

Cursor

要与 Cursor 集成：

1. 创建或编辑 Cursor MCP 配置文件：

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

2. 添加以下配置：

{
  "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",
        "WALLET_PRIVATE_KEY": "your_private_key_here_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"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

将 API 密钥和加密密钥替换为您自己的值。

Claude Desktop

Claude Desktop 集成与 Cursor 集成类似：

1. 创建或编辑 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

2. 添加与 Cursor 所示类似的配置。

可用工具

以下工具可用：

钱包工具

• 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 中显示 "No tools available":

   • 确保您的 MCP 配置文件格式正确
   • 检查是否已安装 Node.js 并且可以从路径访问
   • 验证到您的项目的完整路径是否正确
   • 在配置中使用 Node.js 可执行文件的完整路径

2. "Client closed" 错误:

   • 检查 MCP 服务器日志中是否有错误
   • 确保您的环境变量已正确设置
   • 尝试重新启动 Cursor
   • 检查您的配置 JSON 中是否存在语法错误

3. 连接问题:

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

安全注意事项

• 此项目处理敏感的区块链操作
• 永远不要分享您的私钥或助记词
• 使用环境变量进行敏感配置
• 在提交之前始终验证交易
• 在主网上使用之前，先在测试网上进行广泛测试

贡献

欢迎贡献！ 请随时提交 Pull Request。

许可证

该项目已获得 MIT 许可证的许可 - 有关详细信息，请参见 LICENSE 文件。