项目介绍

本项目是Cosmic 图协议（Cosmic Graph Protocol）的Cyberlink链上数据索引模块。通过IBC跨链通信能力，提供链上数据查询接口。

安装指南

先决条件

• 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}"
  }
}

功能模块

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 或 -n：指定目标节点地址
• --port 或 -p：设置RPC端口
• --gas 或 -g：指定交易_gas_价格
• --fee 或 -f：设置交易费用

嵌入式规则

支持通过配置文件定义自定义规则：

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

扩展说明

用户可以通过扩展Config和Rules结构，实现更多功能或定制化需求。

报告问题

如遇任何问题，请提交至项目GitHub仓库： https://github.com/your-repository/issues

注意： 本项目的使用受到相关协议和条款的约束，请确保在合法合规的前提下进行操作。