サイバーリンク MCP サーバー

Cosmosベースのブロックチェーン上でCW-Socialスマートコントラクトとやり取りするためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、ブロックチェーン上のエンティティ間の意味的関係であるサイバーリンクの作成、更新、およびクエリのための標準化されたインターフェースを提供します。

特徴

コアオペレーション
- サイバーリンクの作成、読み取り、更新、削除
- カスタム識別子を持つ名前付きサイバーリンクのサポート
- 効率的な処理のためのバッチ操作
- フィルタリングとページネーションを備えた豊富なクエリ機能
トランザクション管理
- リアルタイムのトランザクション監視とステータスポーリング
- 詳細なトランザクション結果とエラー処理
- 内部および外部トランザクション署名のサポート
- トークン転送機能
高度な機能
- Hugging Faceトランスフォーマーによる意味埋め込み生成
- モデル操作のリアルタイム進捗追跡
- 意味的マッチングのためのコサイン類似度計算
- フォーマットされた ID (fid) とグローバル ID (gid) を備えた柔軟な ID システム
- UTC をサポートする時間範囲ベースのクエリ
- 所有者ベースのフィルタリングと統計

前提条件

Node.js 16以上
npm または yarn パッケージマネージャー
実行中のCosmosブロックチェーンノードへのアクセス
取引に十分な資金があるウォレット
開発用カーソルIDE
AI支援のためのClaudeデスクトップ

インストール

リポジトリをクローンします。

git clone https://github.com/your-org/cw-social-mcp.git
cd cw-social-mcp

依存関係をインストールします:

npm install

プロジェクトをビルドします。

npm run build

環境変数を構成する（構成セクションを参照）

構成

MCPサーバーのセットアップ

~/.cursor/mcp.jsonにある設定ファイルを作成または変更します。

{
  "mcpServers": {
    "cw-graph": {
      "command": "node",
      "args": ["PATH_TO_YOUR_PROJECT/dist/index.js"],
      "env": {
        "NODE_URL": "http://localhost:26657",
        "WALLET_MNEMONIC": "your wallet mnemonic phrase",
        "CONTRACT_ADDRESS": "your contract address",
        "DENOM": "stake",
        "BENCH32_PREFIX": "cyber"
      }
    }
  }
}

必要な構成

必要な環境変数:

PATH_TO_YOUR_PROJECT : プロジェクトディレクトリへの絶対パス
NODE_URL : CosmosブロックチェーンノードURL
CONTRACT_ADDRESS : デプロイされたスマートコントラクトアドレス

オプション構成

オプションの環境変数:

WALLET_MNEMONIC : 署名用のウォレットニーモニック（デフォルト: なし - トランザクションは署名されません）
DENOM : トークンの額面（デフォルト: "stake")
BENCH32_PREFIX : BECH32 プレフィックス

利用可能なツール

サイバーリンクマネジメント

作成ツール

サイバーリンクを作成

説明: 単一のサイバーリンクを作成する
必須: type
オプション: from 、 to 、 value

サイバーリンク2を作成

説明: ノード+リンクを作成
必須: node_type 、 link_type
オプション: node_value 、 link_value 、 link_to_existing_id 、 link_from_existing_id

名前付きサイバーリンクを作成する

説明: 名前付きサイバーリンクを作成する (管理者のみ)
必須: name 、 cyberlink

サイバーリンクを作成する

説明: サイバーリンクを一括作成
必須: cyberlinks[]

修正ツール

アップデート_サイバーリンク

説明: 既存のサイバーリンクを更新
必須: gid 、 cyberlink

サイバーリンクを削除

説明: サイバーリンクを削除
必須: gid

埋め込みによる更新

説明: セマンティック埋め込みを追加する
必須: formatted_id

クエリ操作

基本的なクエリ

クエリ_by_gid

説明: グローバルIDで取得
必須: gid

クエリバイfid

説明: フォーマットされたIDで取得
必須: fid

クエリ_サイバーリンク

説明: ページ区切りですべてをリストします
パラメータ: limit 、 start_after

クエリ名サイバーリンク

説明: 名前付きサイバーリンクの一覧
パラメータ: limit 、 start_after

GIDによるクエリ

説明: IDで複数取得
必須: gids[]

フィルタリングされたクエリ

クエリ_サイバーリンク_by_type

説明: タイプ別にフィルタリング
必須: type

クエリ_サイバーリンクス_by_from

説明: ソースでフィルタリング
必須: from

クエリ_サイバーリンクス_by_to

説明: ターゲットでフィルタリング
to :

所有者とタイプによるサイバーリンクのクエリ

説明: 所有者とタイプでフィルタリング
必須: owner 、 type

時間ベースのクエリ

所有者時間によるサイバーリンクのクエリ

説明: 作成時間でフィルタリング
必須: owner 、 start_time

クエリ_サイバーリンクス_by_owner_time_any

説明: いつでもフィルタリング
必須: owner 、 start_time

システム操作

契約情報

クエリ最終ID

説明: 最後に割り当てられたIDを取得する

クエリ構成

説明: 契約構成を取得する

クエリデバッグ状態

説明: デバッグ状態を取得する (管理者のみ)

グラフ統計を取得する

説明: グラフ統計を取得する

取引とウォレット

クエリトランザクション

説明: トランザクションステータスを取得する
必須: transaction_hash

トランザクションステータスの取得

説明: 詳細なトランザクションステータスを取得する
必須: transaction_hash

ウォレット残高照会

説明: ウォレットの残高を取得する

トークン送信

説明: トークンの転送
必須: recipient 、 amount

クエリパラメータ

時間範囲の形式

すべてのタイムスタンプは ISO 8601 形式である必要があります
例: 2024-06-01T12:00:00Z
指定されていない場合はUTCタイムゾーンが想定されます
start_timeは必須、 end_timeはオプションです

ページネーション

start_after : ページネーションカーソル
limit : 1ページあたりの結果数（デフォルト: 50）

発達

ビルドコマンド

# Production build
npm run build

# Development mode
npm run dev

プロジェクト構造

src/
├── index.ts                # Entry point
├── cyberlink-service.ts    # Core service
├── services/
│   ├── embedding.service.ts  # Semantic analysis
│   └── __tests__/           # Test suite
└── types.ts                # Type definitions

cursor_rules/
└── chat_history.mdc       # Chat rules

エラーコード

無効なパラメータ

説明: 無効なパラメータ
一般的な原因: 必須フィールドの不足、形式が間違っている

メソッドが見つかりません

説明: 不明なツール
一般的な原因: ツール名の入力ミス、非推奨のツール

内部エラー

説明: システムエラー
一般的な原因: ネットワークの問題、契約エラー

SSE経由でMCPを実行する

Dockerを使ってMCPサーバーを実行し、SSEサーバーとして動作させることができます。これにより、Hugging Faceモデルのキャッシュが実行間で保持され、環境変数が.envファイルから読み込まれるようになります。

docker run \
  --name cw-social \
  -v $(pwd)/hf-cache:/app/hf-cache \
  --env-file .env \
  -p 8000:8000 \
  cw-social-mcp

-v $(pwd)/hf-cache:/app/hf-cacheはモデルキャッシュ用のローカルディレクトリをマウントするため、モデルは毎回再ダウンロードされません。
--env-file .env``.envファイルから環境変数を読み込みます。
-p 8000:8000ポート 8000 でサーバーを公開します。
--name cw-social管理を容易にするためにコンテナに名前を付けます。

貢献

リポジトリをフォークする
機能ブランチを作成する ( git checkout -b feature/amazing-feature )
変更をコミットします（ git commit -m 'Add amazing feature' ）
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

Cyberlink MCP Server

Integrations