MCP Cw Graph

🚀 Cosmic Graph Protocol Cyberlink Data Index Module

This project is the on-chain data indexing module of the Cosmic Graph Protocol on the Cyberlink chain. It provides on-chain data query interfaces through IBC cross-chain communication capabilities.

🚀 Quick Start

This module serves as the on - chain data indexing component of the Cosmic Graph Protocol on the Cyberlink chain, offering on - chain data query interfaces via IBC cross - chain communication.

📦 Installation

Prerequisites

• Node.js version >=16.0.0
• npm version >=8.0.0
• Git installed

Download the Code

Clone the project repository using the following commands:

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

Install Dependencies

Run the following command in the project root directory:

npm install

Configuration File

Write the following configuration content into config.json:

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

✨ Features

MCP Tools

• mcp_cw_graph_create_cyberlink - Create a new Cyberlink
• mcp_cw_graph_create_named_cyberlink - Create a named Cyberlink with an identifier
• mcp_cw_graph_create_cyberlinks - Create multiple Cyberlinks in batches
• mcp_cw_graph_update_cyberlink - Update an existing Cyberlink by ID
• mcp_cw_graph_delete_cyberlink - Delete a Cyberlink by ID

Basic Queries

• mcp_cw_graph_query_by_id - Query a single Cyberlink using a numeric ID
• mcp_cw_graph_query_by_formatted_id - Query a Cyberlink using a formatted ID
• mcp_cw_graph_query_cyberlinks - Query all Cyberlinks with pagination
• mcp_cw_graph_query_named_cyberlinks - Query all named Cyberlinks
• mcp_cw_graph_query_by_ids - Query Cyberlinks using multiple IDs

Advanced Queries

• mcp_cw_graph_query_by_owner - Filter Cyberlinks by owner address
• mcp_cw_graph_query_by_time_range - Query Cyberlinks by creation time range
• mcp_cw_graph_query_by_time_range_any - Query Cyberlinks within any time range (creation or update)

System Queries

• mcp_cw_graph_query_last_id - Get the last assigned Cyberlink ID
• mcp_cw_graph_query_config - Query the contract configuration
• mcp_cw_graph_query_debug_state - Query the debug state (admin only)
• mcp_cw_graph_get_tx_status - Check the transaction status and get the Cyberlink ID

Wallet Operations

• mcp_cw_graph_query_wallet_balance - Get wallet address and balance information
• mcp_cw_graph_transfer - Initiate a cross - chain transfer operation

🔧 Technical Details

Query Parameters

All query commands support the following common parameters:

• --node or -n: Specify the target node address
• --port or -p: Set the RPC port
• --gas or -g: Specify the transaction gas price
• --fee or -f: Set the transaction fee

Embedded Rules

Support defining custom rules through the configuration file:

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

📚 Documentation

Users can implement more functions or customized requirements by extending the Config and Rules structures.

💡 Reporting Issues

If you encounter any issues, please submit them to the project's GitHub repository: https://github.com/your-repository/issues

⚠️ Important Note

The use of this project is subject to relevant agreements and terms. Please ensure that you operate within the legal and compliant framework.