NEAR Protocol Full-Featured MCP Server

基本能力

产品定位

NEAR Protocol Full-Featured MCP Server 是一个为NEAR Protocol区块链设计的模型上下文协议（MCP）服务器，主要用于本地开发和测试，允许通过MCP客户端连接的大型语言模型（LLMs）查询区块链数据并执行交易。

核心功能

• 账户管理：获取账户余额、查看账户状态、获取账户详情、创建子账户、删除账户。
• 交易功能：发送代币、调用智能合约函数、批量执行操作、部署合约、查看函数调用。
• 密钥管理：获取访问密钥、添加全访问密钥、添加函数调用密钥、删除访问密钥。
• 签名验证：验证消息签名。

适用场景

• 本地开发和测试NEAR Protocol区块链应用。
• 通过MCP客户端（如Claude Desktop）与NEAR区块链交互。
• 执行智能合约调用和交易操作。

工具列表

• get_account_balance：获取指定账户的余额。
• view_account_state：查看指定合约账户的原始键值状态。
• get_account_details：获取指定NEAR账户的详细信息。
• create_sub_account：创建子账户。
• delete_account：删除账户。
• send_tokens：发送代币。
• call_function：调用智能合约函数。
• batch_actions：批量执行操作。
• deploy_contract：部署合约。
• view_function：查看函数调用。
• get_access_keys：获取访问密钥。
• add_full_access_key：添加全访问密钥。
• add_function_call_key：添加函数调用密钥。
• delete_access_key：删除访问密钥。
• verify_signature：验证签名。

常见问题解答

• 服务器无法启动：检查终端错误，确保环境变量正确设置。
• 客户端无法连接：检查配置文件语法和路径，重启客户端。
• 工具错误：检查服务器终端输出，常见问题包括余额不足、账户ID错误或网络问题。

使用教程

使用依赖

• Node.js：版本16或更高。
• npm：通常随Node.js一起安装。
• NEAR账户：可选，使用现有账户或通过助记词生成。
• NEAR网络：指定networkId（testnet或mainnet）。

安装教程

1. 安装依赖： bash npm install near-mcp-server
2. 配置环境变量： dotenv MNEMONIC="word1 word2 word3 word4 word5 word6 word7 word8 word9 word10 word11 word12" NEAR_NETWORK_ID="testnet"
3. 构建服务器： bash npm run build

调试方式

1. 启动服务器： bash npm start 或 bash node build/index.js
2. 检查服务器日志：
3. 服务器成功初始化后会输出连接详情。
4. 错误和日志会显示在终端中。

许可证

该项目遵循 MIT 开源许可条款。