金大哥 - cyb-mcp MCP 详情

article

README

🚀 Cyb MCP Server

Cyb MCP Server 是一个模型上下文协议（MCP）服务器，用于与 Cyber 集成。该服务器使 AI 代理能够与去中心化知识图谱进行交互，创建网络链接（cyberlinks），并通过 Cyber 网络从 IPFS 中检索内容。

本项目是对 Great Web Foundation 的贡献，旨在支持去中心化、抗审查网络的发展。

Cyb MCP 演示 1

Cyb MCP 演示 2

✨ 主要特性

sendCyberlink：使用 CID 或纯文本在 Cyber 网络的 IPFS CID 之间创建网络链接。
searchQuery：搜索 Cyber 知识图谱，并从 IPFS 中检索内容。
getCyberlink：通过 CID 从 IPFS 中检索内容。

📦 安装指南

安装依赖项：
```
npm install
```
构建项目：
```
npm run build
```

配置环境变量：

# 所有操作都需要
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"

运行服务器：
```
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 - 伟大网络的哲学

cyb-mcp