<div align="center"> <img src="assets/near-mcp.svg" alt="NEAR MCP Logo" width="200" /> </div>

NEAR MCP

此项目是一个与模型上下文协议（MCP）兼容的服务器，用于与NEAR区块链进行交互。该工具提供了一种方式，使大型语言模型（LLMs）和AI代理能够安全地访问和与NEAR账户及区块链功能进行交互。

快速开始

这是如何使用claude代码CLI快速开始使用near-mcp服务器的方法：

npm install -g @anthropic-ai/claude-code
claude mcp add near-mcp npx @nearai/near-mcp@latest run
claude

或者在Phala Cloud上远程部署MCP服务器，请查看此处的说明。

安装

near-mcp意在与兼容MCP的客户端一起使用。更多详情请参阅MCP文档

添加到claude代码 CLI：

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

通过JSON配置添加到claude桌面：

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

添加到goose：

┌   goose-configure
│
◇  您想要配置什么？
│  添加扩展
│
◇  您想要添加哪种类型的扩展？
│  命令行扩展
│
◇  您希望将此扩展命名为？
│  near-mcp
│
◇  应该运行哪个命令？
│  npx @nearai/near-mcp@latest run
│
◇  请设置此工具的超时时间（秒）：
│  60
│
◇  您是否要添加环境变量？
│  不
│
└  已添加near-mcp扩展

或者您可以全局安装并直接使用它。

# 全局安装
npm install -g @nearai/near-mcp@latest

# 或者直接使用npx
npx @nearai/near-mcp@latest run

可用工具

请参阅TOOLS.md以获取可用工具及其参数列表。

与AI模型的集成

此工具旨在与支持模型上下文协议的AI模型一起使用。它使AI助手能够：

1. 代表用户管理NEAR账户
2. 检查账户余额和状态
3. 签署并发送交易
4. 创建新账户并管理访问密钥
5. 查看和执行智能合约

安全注意事项

• 此MCP应本地运行。账户私钥存储在MCP服务器运行位置的本地未加密密钥库中。
• 底层模型不应有权查看它们所交互账户的私钥，除非有一个例外情况。import_account工具允许模型从私钥导入账户。这需要用户向模型提供私钥。

贡献

我们欢迎对NEAR MCP服务器的贡献！请参阅CONTRIBUTING.md文件了解更多信息。

报告问题

如果您发现了一个错误或有功能请求，请在GitHub仓库中打开一个issue。