Integrations
Provides integration for Cursor IDE, a GitHub product, enabling management of cyberlinks and semantic relationships through a standardized interface to the CW-Social smart contract.
Runs as a Node.js application, providing MCP tools for creating, querying, and managing cyberlinks and wallet operations on Cosmos-based blockchains.
Cyberlink MCP Server
A Model Context Protocol (MCP) server for interacting with the CW-Social smart contract on Cosmos-based blockchains. This server provides a standardized interface for creating, updating, and querying cyberlinks - semantic relationships between entities on the blockchain.
Features
- Core Operations
- Create, read, update, and delete cyberlinks
- Support for named cyberlinks with custom identifiers
- Batch operations for efficient processing
- Rich query capabilities with filtering and pagination
- Transaction Management
- Real-time transaction monitoring and status polling
- Detailed transaction results and error handling
- Support for both internal and external transaction signing
- Token transfer capabilities
- Advanced Features
- Semantic embedding generation via Hugging Face transformers
- Real-time progress tracking for model operations
- Cosine similarity calculations for semantic matching
- Flexible ID system with formatted IDs (fids) and global IDs (gids)
- Time-range based queries with UTC support
- Owner-based filtering and statistics
Prerequisites
- Node.js 16 or higher
- npm or yarn package manager
- Access to a running Cosmos blockchain node
- Wallet with sufficient funds for transactions
- Cursor IDE for development
- Claude Desktop for AI assistance
Installation
- Clone the repository:
- Install dependencies:
- Build the project:
- Configure environment variables (see Configuration section)
Configuration
MCP Server Setup
Create or modify the configuration file at ~/.cursor/mcp.json
:
Required Configuration
Required environment variables:
PATH_TO_YOUR_PROJECT
: Absolute path to project directoryNODE_URL
: Cosmos blockchain node URLCONTRACT_ADDRESS
: Deployed smart contract address
Optional Configuration
Optional environment variables:
WALLET_MNEMONIC
: Wallet mnemonic for signing (default: none - transactions will be unsigned)DENOM
: Token denomination (default: "stake")BENCH32_PREFIX
: BECH32 prefix
Available Tools
Cyberlink Management
Creation Tools
create_cyberlink
- Description: Create single cyberlink
- Required:
type
- Optional:
from
,to
,value
create_cyberlink2
- Description: Create node + link
- Required:
node_type
,link_type
- Optional:
node_value
,link_value
,link_to_existing_id
,link_from_existing_id
create_named_cyberlink
- Description: Create named cyberlink (admin only)
- Required:
name
,cyberlink
create_cyberlinks
- Description: Batch create cyberlinks
- Required:
cyberlinks[]
Modification Tools
update_cyberlink
- Description: Update existing cyberlink
- Required:
gid
,cyberlink
delete_cyberlink
- Description: Remove cyberlink
- Required:
gid
update_with_embedding
- Description: Add semantic embedding
- Required:
formatted_id
Query Operations
Basic Queries
query_by_gid
- Description: Get by global ID
- Required:
gid
query_by_fid
- Description: Get by formatted ID
- Required:
fid
query_cyberlinks
- Description: List all with pagination
- Parameters:
limit
,start_after
query_named_cyberlinks
- Description: List named cyberlinks
- Parameters:
limit
,start_after
query_by_gids
- Description: Get multiple by IDs
- Required:
gids[]
Filtered Queries
query_cyberlinks_by_type
- Description: Filter by type
- Required:
type
query_cyberlinks_by_from
- Description: Filter by source
- Required:
from
query_cyberlinks_by_to
- Description: Filter by target
- Required:
to
query_cyberlinks_by_owner_and_type
- Description: Filter by owner & type
- Required:
owner
,type
Time-Based Queries
query_cyberlinks_by_owner_time
- Description: Filter by creation time
- Required:
owner
,start_time
query_cyberlinks_by_owner_time_any
- Description: Filter by any time
- Required:
owner
,start_time
System Operations
Contract Info
query_last_id
- Description: Get last assigned ID
query_config
- Description: Get contract config
query_debug_state
- Description: Get debug state (admin only)
get_graph_stats
- Description: Get graph statistics
Transaction & Wallet
query_transaction
- Description: Get tx status
- Required:
transaction_hash
get_tx_status
- Description: Get detailed tx status
- Required:
transaction_hash
query_wallet_balance
- Description: Get wallet balances
send_tokens
- Description: Transfer tokens
- Required:
recipient
,amount
Query Parameters
Time Range Format
- All timestamps must be in ISO 8601 format
- Example:
2024-06-01T12:00:00Z
- UTC timezone is assumed if not specified
start_time
is required,end_time
is optional
Pagination
start_after
: Pagination cursorlimit
: Results per page (default: 50)
Development
Build Commands
Project Structure
Error Codes
InvalidParams
- Description: Invalid parameters
- Common causes: Missing required fields, wrong format
MethodNotFound
- Description: Unknown tool
- Common causes: Typo in tool name, deprecated tool
InternalError
- Description: System error
- Common causes: Network issues, contract errors
Run MCP over SSE
You can run the MCP server using Docker to turn it into an SSE server. This ensures the Hugging Face model cache is persisted between runs and that environment variables are loaded from your .env file.
-v $(pwd)/hf-cache:/app/hf-cache
mounts a local directory for model caching, so models are not re-downloaded every time.--env-file .env
loads environment variables from your.env
file.-p 8000:8000
exposes the server on port 8000.--name cw-social
names your container for easier management.
Contributing
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A Model Context Protocol server for creating, updating, and querying semantic relationships (cyberlinks) on Cosmos-based blockchains through integration with Cursor IDE and Claude Desktop.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server that enables Claude AI to interact with the Solana blockchain through a standardized interface, providing tools for transactions, account queries, and wallet management.Last updated -6069Apache 2.0
- -securityAlicense-qualityA Model Context Protocol server implementation that enables LLMs to interact with NebulaGraph database for graph exploration, supporting schema understanding, queries, and graph algorithms.Last updated -16PythonApache 2.0
- AsecurityAlicenseAqualityA Model Context Protocol server that provides expert guidance for Dojo and Cairo development on Starknet, offering specialized knowledge and assistance for building onchain worlds using the Dojo Entity Component System framework.Last updated -715TypeScriptMIT License
- -securityFlicense-qualityA Model Context Protocol server that provides onchain tools for Claude AI, allowing it to interact with the Solana blockchain through a standardized interface for operations like managing assets, executing token operations, and retrieving network information.Last updated -6TypeScript