Cyb MCP

🚀 Cyb MCP Server

A Model Context Protocol (MCP) server for integrating with the Cyber. This server enables AI agents to interact with the decentralized knowledge graph, create cyberlinks, and retrieve content from IPFS through the Cyber network.

This project is a contribution to the Great Web Foundation, supporting the development of a decentralized, censorship-resistant web.

🚀 Quick Start

The Cyb MCP Server is a powerful tool that allows AI agents to interact with the Cyber network. Here's how you can get started.

✨ Features

• sendCyberlink: Create cyberlinks between IPFS CIDs on the Cyber network using CIDs or plain texts.
• searchQuery: Search the Cyber knowledge graph and retrieve content from IPFS.
• getCyberlink: Retrieve content from IPFS by CID.

📦 Installation

1. Install dependencies:

   npm install
   

2. Build the project:

   npm run build
   

3. Configure environment variables:

   # Required for all operations
   export CYBER_RPC_URL="https://rpc.bostrom.cybernode.ai"
   export CYBER_GATEWAY="https://gateway.ipfs.cybernode.ai"
   
   # Optional - only needed for sendCyberlink tool
   export CYBER_MNEMONIC="your twelve word mnemonic phrase here"
   

4. Run the server:

   npm start
   

💻 Usage Examples

Usage with Claude Desktop

Add to your Claude Desktop configuration:

{
  "mcpServers": {
    "cyb": {
      "command": "node",
      "args": ["/path/to/cyb-mcp/dist/index.js"],
      "env": {
        "CYBER_RPC_URL": "https://rpc.bostrom.cybernode.ai",
        "CYBER_GATEWAY": "https://gateway.ipfs.cybernode.ai"
      }
    }
  }
}

For sendCyberlink functionality, add mnemonic:

{
  "mcpServers": {
    "cyb": {
      "command": "node",
      "args": ["/path/to/cyb-mcp/dist/index.js"],
      "env": {
        "CYBER_MNEMONIC": "your twelve word mnemonic phrase here",
        "CYBER_RPC_URL": "https://rpc.bostrom.cybernode.ai",
        "CYBER_GATEWAY": "https://gateway.ipfs.cybernode.ai"
      }
    }
  }
}

Tools

sendCyberlink

Creates a cyberlink between two pieces of content. Requires mnemonic to be configured.

Parameters:

Note: This tool will return an error if no mnemonic is provided in the configuration.

searchQuery

Searches the Cyber knowledge graph. No mnemonic required.

Parameters:

Returns:

• Array of content items in the response.
• Each search result as a separate item.
• Supports both text and image content when retrieveContent is true.
• Images are automatically detected and returned as base64-encoded data.

getCyberlink

Retrieves content from IPFS by CID through the Cyber gateway. No mnemonic required.

Parameters:

Features:

• Automatic image detection based on MIME type and content headers.
• Returns images as base64-encoded data with proper MCP image content type.
• Returns text content as formatted text.
• Supports PNG, JPEG, GIF, WebP, and SVG images.

📚 Documentation

Usage Modes

The MCP server supports two usage modes:

Read-Only Mode (No Mnemonic)

• Available tools: searchQuery, getCyberlink.
• Perfect for exploring and retrieving content from the Cyber network.
• No wallet or signing capabilities.

Full Mode (With Mnemonic)

• Available tools: sendCyberlink, searchQuery, getCyberlink.
• Includes wallet for creating cyberlinks and signing transactions.
• Requires mnemonic phrase for wallet access.

🔧 Technical Details

The mnemonic is stored in environment variables. Keep your mnemonic secure and never commit it to version control.

📄 Links

• Main Project: cyb.ai - The superintelligence for the decentralized web.
• Documentation: cyber.page - Philosophy of Great Web.