Cyb MCP

🚀 Cyb MCP Server

このプロジェクトは、Cyberと統合するためのModel Context Protocol (MCP)サーバーです。このサーバーを通じて、AIエージェントは分散型知識グラフとやり取りし、サイバーリンクを作成し、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

2つのコンテンツ間にサイバーリンクを作成します。ニーモニックの設定が必要です。

パラメータ：

• 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サーバーは2つの使用モードをサポートしています：

読み取り専用モード（ニーモニックなし）

• 使用可能なツール：searchQuery、getCyberlink
• Cyberネットワークからのコンテンツの探索と取得に最適
• ウォレットや署名機能はありません

フルモード（ニーモニックあり）

• 使用可能なツール：sendCyberlink、searchQuery、getCyberlink
• サイバーリンクの作成とトランザクションの署名のためのウォレットが含まれます
• ウォレットアクセスにはニーモニックフレーズが必要です

セキュリティ

ニーモニックは環境変数に保存されます。ニーモニックを安全に保管し、バージョン管理システムにコミットしないでください。

リンク

• メインプロジェクト：cyb.ai - 分散型ウェブのための超知能
• ドキュメント：cyber.page - Great Webの哲学