Near MCP Server

🚀 NEAR 協議 MCP 服務器使用指南

本指南將幫助您快速搭建並使用 NEAR 協議 MCP 服務器，該服務器提供了豐富的賬戶操作、合約交互等功能，助您高效開展相關業務。

🚀 快速開始

安裝與配置

1. 安裝依賴

運行以下命令安裝項目所需的依賴：

npm install near-api-js zod @types/node --save

2. 創建項目結構

項目結構應按以下方式組織：

your-near-mcp-server/
├── build/                 # 編譯輸出目錄
├── src/                  # 源代碼
│   └── index.ts          # 主程序文件
└── .env                   # 環境變量配置

3. 配置環境變量

在項目根目錄下創建或編輯 .env 文件，並添加以下內容：

MNEMONIC=your-24-word-mnemonic-or-empty
NEAR_NETWORK_ID=testnet # 可選值：testnet、mainnet-beta

啟動服務器

開發模式啟動

使用以下命令在開發模式下啟動服務器：

npm run dev

生產模式啟動

使用以下命令在生產模式下啟動服務器：

npm start

✨ 主要特性

此 MCP 服務器具備以下強大功能：

1. 賬戶操作：
   • 查詢餘額
   • 查看賬戶詳情
   • 創建子賬戶
2. 合約交互：
   • 調用合約方法
   • 部署新合約
3. 資產轉移：
   • 發送 NEAR 代幣
   • 轉賬到子賬戶
4. 狀態查詢：
   • 獲取區塊信息
   • 查看交易記錄
5. 安全功能：
   • 管理訪問密鑰
   • 刪除賬戶
   • 驗證簽名

💻 使用示例

基礎用法

以下是與 Claude Desktop 交互的使用示例：

示例 1：查詢餘額

What's the balance of my account?

示例 2：調用合約方法

Call the 'add_message' function on 'guest-book.testnet' with arguments {"text": "Hello from MCP!"}

示例 3：部署合約

Deploy this contract (provide base64 WASM) to my account

📚 詳細文檔

安全注意事項

私鑰管理

• 避免將助記詞存儲在不安全的位置。
• 在生產環境中，建議使用硬件錢包或其他安全措施。

訪問控制

• 限制對高權限操作的訪問。
• 定期審計和監控系統活動。

輸入驗證

• 對用戶提供的所有輸入進行嚴格的格式檢查和消毒處理。

網絡問題

• 確保服務器具有穩定的網絡連接。
• 配置適當的錯誤處理機制以應對網絡波動。

開發與調試

調試命令

使用以下命令檢查 TypeScript 錯誤：

npm run check-index

常見問題排查

• 服務未啟動：
  • 檢查控制檯輸出，查看是否有錯誤信息。
  • 確保所有依賴項已正確安裝。
• 連接問題：
  • 驗證 NEAR 網絡 ID 是否正確配置。
  • 確保助記詞有效或為空（空表示使用默認錢包）。
• 功能異常：
  • 檢查日誌文件，獲取詳細錯誤信息。
  • 查看 NEAR API 文檔，確認調用方式正確。

高級配置

自定義網絡

在 src/index.ts 中修改網絡配置：

const config = {
  networkId: process.env.NEAR_NETWORK_ID || 'testnet',
  mnemonic: process.env.MNEMONIC,
}

擴展功能

• 實現更多 NEAR API 方法。
• 添加日誌記錄和監控系統。
• 開發 Web 接口以便遠程調用。

文檔擴展

如需進一步瞭解 NEAR 協議，請參考：

• NEAR 官方文檔
• Near CLI 工具

通過以上步驟，您可以輕鬆設置並運行一個功能完善的 NEAR 協議 MCP 服務器，並與 Claude Desktop 集成使用。如果在配置或使用過程中遇到任何問題，請參考項目文檔或聯繫社區支持獲取幫助。