关键词

NEAR区块链LLMAI 智能体Web3账户管理交易智能合约

项目简介

NEAR MCP Server 是一个与 Model Context Protocol (MCP) 兼容的服务器，它充当 LLM 和 NEAR 区块链之间的桥梁。通过提供工具化的接口，使 LLM 能够安全地访问和操作 NEAR 区块链上的资源和功能。该服务器旨在简化 AI 智能体与去中心化应用（dApps）的集成，为构建基于区块链的下一代 AI 应用提供基础设施。

主要功能点

  • 账户管理: 支持 NEAR 账户的本地密钥对管理，包括导入、导出、移除本地账户，以及创建和删除链上账户。
  • 信息查询: 允许查询 NEAR 账户的余额、状态、访问密钥等信息，方便 LLM 理解账户状态。
  • 交易操作: 支持 NEAR 代币和 NEAR Fungible Tokens (FTs) 的发送，使 LLM 能够驱动价值转移。
  • 智能合约交互: 提供调用智能合约只读方法的功能，方便 LLM 获取链上数据。
  • 数据签名: 支持使用本地账户私钥对数据进行签名，为安全操作提供保障。
  • 工具列表: 提供列出服务器可用工具的功能，方便客户端了解服务器能力。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm。

  2. 全局安装或使用 npx 运行: 你可以选择全局安装 'near-mcp' 或直接使用 'npx' 运行。

    • 全局安装: 
      npm install -g @nearai/near-mcp@latest
    • 使用 npx (无需全局安装): 无需额外安装，每次运行命令时会自动下载。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令才能连接。以下是针对不同 MCP 客户端的配置示例，核心是指定 'near-mcp' 的启动命令。

针对 Claude 客户端的配置：

  • 通过 Claude CLI 添加:

    claude mcp add near-mcp npx @nearai/near-mcp@latest run

  • 通过 JSON 配置文件添加:

    {
  "mcpServers": {
    "near-mcp": {
      "command": "npx",
      "args": ["-y", "@nearai/near-mcp@latest", "run"],
      "env": {}
    }
  }
}

    配置参数说明:

    • 'server name': 'near-mcp' (服务器名称，客户端用于标识)
    • 'command': 'npx' (执行命令，用于启动服务器)
    • 'args': '["-y", "@nearai/near-mcp@latest", "run"]' (命令参数，'-y' 自动确认安装，'@nearai/near-mcp@latest' 指定包名和版本，'run' 是 'near-mcp' 的运行命令)

针对 Goose 客户端的配置：

Goose 客户端通常通过交互式命令行配置扩展，按照提示填写以下信息：

◇  What type of extension would you like to add?
│  Command-line Extension

◇  What would you like to call this extension?
│  near-mcp

◇  What command should be run?
│  npx @nearai/near-mcp@latest run

◇  Please set the timeout for this tool (in secs):
│  60

◇  Would you like to add environment variables?
│  No

配置参数说明:

  • 'Extension Name': 'near-mcp' (扩展名称，Goose 客户端内部标识)
  • 'Command': 'npx @nearai/near-mcp@latest run' (启动服务器的完整命令)
  • 'Timeout': '60' (工具超时时间，根据需要设置)

基本使用方法

  1. 启动 NEAR MCP 服务器: 根据你的安装方式，运行以下命令启动服务器。

    • 全局安装: 
      near-mcp run
    • 使用 npx: 
      npx @nearai/near-mcp@latest run

  2. 配置 MCP 客户端: 根据你使用的 MCP 客户端（如 Claude, Goose 等）的文档，配置连接到 NEAR MCP 服务器。配置时需要提供服务器的启动命令，通常是 'npx @nearai/near-mcp@latest run'。

  3. 通过 LLM 调用工具: 在 LLM 应用中，你可以通过自然语言指令指示 LLM 调用 NEAR MCP 服务器提供的工具，例如：

    • "查询我的 NEAR 账户余额" (可能触发 'account_view_account_summary' 工具)
    • "发送 0.5 NEAR 到 'receiver_account.testnet'" (可能触发 'tokens_send_near' 工具)
    • "列出可用的智能合约方法 'contract_account.testnet'" (可能触发 'contract_view_functions' 工具)

    具体的工具调用方式和参数需要参考工具的描述和输入参数定义。

安全提示: 'near-mcp' 服务器默认将账户私钥存储在本地未加密的 keystore 中，请在本地安全的环境中运行，并注意保护你的私钥安全。

信息

分类

AI与计算

访问项目