MCP Cw Graph

🚀 宇宙圖協議（Cosmic Graph Protocol）鏈上數據索引模塊

本項目是Cosmic 圖協議（Cosmic Graph Protocol）的Cyberlink鏈上數據索引模塊。藉助IBC跨鏈通信能力，提供便捷的鏈上數據查詢接口，為用戶獲取鏈上數據提供支持。

🚀 快速開始

本項目是Cosmic 圖協議（Cosmic Graph Protocol）的Cyberlink鏈上數據索引模塊，藉助IBC跨鏈通信能力，提供鏈上數據查詢接口。以下是快速上手的步驟。

✨ 主要特性

MCP 工具

• mcp_cw_graph_create_cyberlink - 創建一個新的Cyberlink
• mcp_cw_graph_create_named_cyberlink - 使用標識符創建命名Cyberlink
• mcp_cw_graph_create_cyberlinks - 批量創建多個Cyberlink
• mcp_cw_graph_update_cyberlink - 根據ID更新現有Cyberlink
• mcp_cw_graph_delete_cyberlink - 根據ID刪除Cyberlink

基本查詢

• mcp_cw_graph_query_by_id - 使用數字ID查詢單個Cyberlink
• mcp_cw_graph_query_by_formatted_id - 使用格式化ID查詢Cyberlink
• mcp_cw_graph_query_cyberlinks - 分頁查詢所有Cyberlink
• mcp_cw_graph_query_named_cyberlinks - 查詢所有命名Cyberlink
• mcp_cw_graph_query_by_ids - 使用多個ID查詢Cyberlink

高級查詢

• mcp_cw_graph_query_by_owner - 根據所有者地址過濾Cyberlink
• mcp_cw_graph_query_by_time_range - 根據創建時間範圍查詢Cyberlink
• mcp_cw_graph_query_by_time_range_any - 查詢任意時間範圍內（創建或更新）的Cyberlink

系統查詢

• mcp_cw_graph_query_last_id - 獲取最後一個分配的Cyberlink ID
• mcp_cw_graph_query_config - 查詢合約配置
• mcp_cw_graph_query_debug_state - 查詢調試狀態（僅限管理員）
• mcp_cw_graph_get_tx_status - 檢查交易狀態並獲取Cyberlink ID

錢包操作

• mcp_cw_graph_query_wallet_balance - 獲取錢包地址及餘額信息
• mcp_cw_graph_transfer - 發起跨鏈轉賬操作

📦 安裝指南

先決條件

• Node.js 版本 >=16.0.0
• npm 版本 >=8.0.0
• Git 已安裝

代碼下載

使用以下命令克隆項目倉庫：

git clone git@github.com:your-repository.git
cd cyberlink-cosmic-graph-mcp

安裝依賴項

在項目根目錄運行：

npm install

配置文件

將以下配置內容寫入config.json：

{
  "graph_name": "your_graph_name",
  "chain_id": "your_chain_id",
  "contract_address": "0x...",
  "http_server": {
    "port": ${PORT},
    "host": "${HOST}"
  }
}

🔧 技術細節

查詢參數

所有查詢命令支持以下公共參數：

• --node 或 -n：指定目標節點地址
• --port 或 -p：設置RPC端口
• --gas 或 -g：指定交易_gas_價格
• --fee 或 -f：設置交易費用

嵌入式規則

支持通過配置文件定義自定義規則：

{
  "rules": {
    "rule_name": "rule_description",
    ...
  }
}

📚 詳細文檔

擴展說明

用戶可以通過擴展Config和Rules結構，實現更多功能或定製化需求。

報告問題

如遇任何問題，請提交至項目GitHub倉庫： https://github.com/your-repository/issues

⚠️ 重要提示

本項目的使用受到相關協議和條款的約束，請確保在合法合規的前提下進行操作。