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

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

特徴

• コアオペレーション

  • サイバーリンクの作成、読み取り、更新、削除

  • カスタム識別子を持つ名前付きサイバーリンクのサポート

  • 効率的な処理のためのバッチ操作

  • フィルタリングとページネーションを備えた豊富なクエリ機能

• トランザクション管理

  • リアルタイムのトランザクション監視とステータスポーリング

  • 詳細なトランザクション結果とエラー処理

  • 内部および外部トランザクション署名のサポート

  • トークン転送機能

• 高度な機能

  • Hugging Faceトランスフォーマーによる意味埋め込み生成

  • モデル操作のリアルタイム進捗追跡

  • 意味的マッチングのためのコサイン類似度計算

  • フォーマットされた ID (fid) とグローバル ID (gid) を備えた柔軟な ID システム

  • UTC をサポートする時間範囲ベースのクエリ

  • 所有者ベースのフィルタリングと統計

Related MCP server: Contextual MCP Server

前提条件

• Node.js 16以上

• npm または yarn パッケージマネージャー

• 実行中のCosmosブロックチェーンノードへのアクセス

• 取引に十分な資金があるウォレット

• 開発用カーソルIDE

• AI支援のためのClaudeデスクトップ

インストール

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

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

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

npm install

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

npm run build

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

構成

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管理を容易にするためにコンテナに名前を付けます。

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成する ( git checkout -b feature/amazing-feature )

3. 変更をコミットします（ git commit -m 'Add amazing feature' ）

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

ライセンス

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