Cyb MCP

🚀 Cyb MCP Server

Cyb MCP Server 是一個模型上下文協議（MCP）服務器，用於與 Cyber 集成。該服務器使 AI 代理能夠與去中心化知識圖譜進行交互，創建網絡鏈接（cyberlinks），並通過 Cyber 網絡從 IPFS 中檢索內容。

本項目是對 Great Web Foundation 的貢獻，旨在支持去中心化、抗審查網絡的發展。

✨ 主要特性

• sendCyberlink：使用 CID 或純文本在 Cyber 網絡的 IPFS CID 之間創建網絡鏈接。
• searchQuery：搜索 Cyber 知識圖譜，並從 IPFS 中檢索內容。
• getCyberlink：通過 CID 從 IPFS 中檢索內容。

📦 安裝指南

1. 安裝依賴項：

   npm install
   

2. 構建項目：

   npm run build
   

3. 配置環境變量：

   # 所有操作都需要
   export CYBER_RPC_URL="https://rpc.bostrom.cybernode.ai"
   export CYBER_GATEWAY="https://gateway.ipfs.cybernode.ai"
   
   # 可選 - 僅 sendCyberlink 工具需要
   export CYBER_MNEMONIC="your twelve word mnemonic phrase here"
   

4. 運行服務器：

   npm start
   

💻 使用示例

與 Claude Desktop 配合使用

在你的 Claude Desktop 配置中添加以下內容：

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

若要使用 sendCyberlink 功能，請添加助記詞：

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

📚 詳細文檔

工具說明

sendCyberlink

在兩個內容之間創建網絡鏈接。需要配置助記詞。 參數：

• from：源 CID 或文本內容
• to：目標 CID 或文本內容
• fee：可選的交易費用對象

注意：如果配置中未提供助記詞，此工具將返回錯誤。

searchQuery

搜索 Cyber 知識圖譜。無需助記詞。 參數：

• query：搜索查詢（CID 或文本）
• page：分頁頁碼（默認值：0）
• retrieveContent：是否從 IPFS 中獲取內容（默認值：false）
• limit：要獲取內容的最大結果數（默認值：5）

返回值：

• 響應中的內容項數組
• 每個搜索結果作為單獨的項
• 當 retrieveContent 為 true 時，支持文本和圖像內容
• 圖像會自動檢測並以 base64 編碼數據返回

getCyberlink

通過 Cyber 網關根據 CID 從 IPFS 中檢索內容。無需助記詞。 參數：

• cid：要檢索內容的 IPFS CID

特性：

• 根據 MIME 類型和內容頭自動檢測圖像
• 以正確的 MCP 圖像內容類型將圖像作為 base64 編碼數據返回
• 以格式化文本形式返回文本內容
• 支持 PNG、JPEG、GIF、WebP 和 SVG 圖像

使用模式

MCP 服務器支持兩種使用模式：

只讀模式（無需助記詞）

• 可用工具：searchQuery、getCyberlink
• 非常適合從 Cyber 網絡中探索和檢索內容
• 無需錢包或簽名功能

完整模式（使用助記詞）

• 可用工具：sendCyberlink、searchQuery、getCyberlink
• 包含用於創建網絡鏈接和簽署交易的錢包
• 需要助記詞來訪問錢包

🔧 技術細節

助記詞存儲在環境變量中。請確保助記詞的安全，切勿將其提交到版本控制系統。

📄 許可證

文檔中未提及相關許可證信息。

🔗 相關鏈接

• 主項目：cyb.ai - 去中心化網絡的超級智能
• 文檔：cyber.page - 偉大網絡的哲學