🚀 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 中检索内容。
📦 安装指南
- 安装依赖项：
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 - 伟大网络的哲学