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 - 伟大网络的哲学