Skip to main content
Glama
enesjakozh
piplabs

Story SDK MCP Server

by piplabs
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

ストーリーMCPハブ

このリポジトリは、Story Protocol の Model Context Protocol (MCP) サーバーの中央ハブとして機能します。AI エージェントが Story Protocol のエコシステムとやり取りできるようにするさまざまな MCP サービスを実行および管理するための統合環境を提供します。

プロジェクト構造

story-mcp-hub/
├── storyscan-mcp/       # MCP server for blockchain data queries via StoryScan
├── story-sdk-mcp/       # MCP server for Story Protocol SDK interactions
├── utils/               # Shared utilities for MCP servers
├── .venv/               # Python virtual environment
├── pyproject.toml       # Project dependencies and configuration
├── .python-version      # Python version specification
└── README.md            # This file
graph TD
    subgraph "MCP Hub"
        style MCP Hub fill:#F5F5FF,stroke:#9999CC,stroke-width:2px,rx:10,ry:10
        Agent["AI Agent<br>(Claude, IDEs, Tools)"]
        style Agent fill:#E6E6FA,stroke:#9370DB,stroke-width:2px,rx:8,ry:8
    end

    subgraph "StoryScan MCP Server"
        style StoryScan MCP Server fill:#F0F8FF,stroke:#87CEFA,stroke-width:2px,rx:10,ry:10
        StoryscanService["StoryScan Service"]
        style StoryscanService fill:#E6E6FA,stroke:#9370DB,stroke-width:2px,rx:8,ry:8

        subgraph "StoryScan Tools"
            style StoryScan Tools fill:#F0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:10,ry:10
            StoryscanToolset["Balance & Stats<br>check_balance,<br>get_address_overview,<br>get_transactions,<br>interpret_transaction,<br>get_token_holdings,<br>get_nft_holdings,<br>get_stats"]
            style StoryscanToolset fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8
        end
    end

    subgraph "Story SDK MCP Server"
        style Story SDK MCP Server fill:#F5FFFA,stroke:#98FB98,stroke-width:2px,rx:10,ry:10
        StoryService["Story Service"]
        style StoryService fill:#E6E6FA,stroke:#9370DB,stroke-width:2px,rx:8,ry:8

        subgraph "Story SDK Tools"
            style Story SDK Tools fill:#F0FFF0,stroke:#90EE90,stroke-width:2px,rx:10,ry:10
            IPFSTools["IPFS Tools<br>upload_image_to_ipfs<br>create_ip_metadata"]
            style IPFSTools fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8
            IPTools["IP Management Tools<br>mint_and_register_ip_with_terms<br>get_license_terms,<br>mint_license_tokens,<br>send_ip,<br>create_spg_nft_collection"]
            style IPTools fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8
        end
    end

    subgraph "External Resources"
        style External Resources fill:#FFF0F5,stroke:#FFB6C1,stroke-width:2px,rx:10,ry:10
        IPFS[(IPFS/Pinata<br>Storage)]
        style IPFS fill:#FFE4E1,stroke:#DB7093,stroke-width:2px,rx:15,ry:15
        Blockchain[(Story Protocol<br>Blockchain)]
        style Blockchain fill:#E0F8E0,stroke:#90EE90,stroke-width:2px,rx:15,ry:15
        StoryScan[(StoryScan/Blockscout<br>API)]
        style StoryScan fill:#E6F3FF,stroke:#87CEFA,stroke-width:2px,rx:15,ry:15
    end

    Agent <--MCP Protocol--> StoryService
    Agent <--MCP Protocol--> StoryscanService
    StoryscanService --> StoryscanToolset
    StoryService --> IPFSTools
    StoryService --> IPTools

    StoryscanToolset <--API Calls--> StoryScan
    IPFSTools <--API Calls--> IPFS
    IPTools <--RPC Calls--> Blockchain

Related MCP server: Storybook MCP Server

MCP サーバー

StoryScan MCP サーバー

アドレス残高、トランザクション、ブロックチェーン統計などのブロックチェーン データを照会するためのツールを提供します。

ツール:

  • check_balance : アドレスの残高を確認する

  • get_transactions : アドレスの最近のトランザクションを取得する

  • get_stats : 現在のブロックチェーンの統計情報を取得する

  • get_address_overview : 住所の包括的な概要を取得する

  • get_token_holdings : アドレスのすべての ERC-20 トークン保有数を取得する

  • get_nft_holdings : アドレスのすべてのNFT保有を取得する

  • interpret_transaction : トランザクションの人間が読める解釈を取得する

ストーリーSDK MCPサーバー

Story Protocol の Python SDK と対話するためのツールを提供します。

ツール:

  • get_license_terms : 特定のIDのライセンス条項を取得する

  • mint_license_tokens : 特定の IP とライセンス条件の Mint ライセンス トークン

  • send_ip : ネイティブトークン転送を使用して指定されたアドレスにIPトークンを送信する

  • upload_image_to_ipfs : IPFSにイメージをアップロードし、URIを返す

  • create_ip_metadata : 特定の画像URIのNFTメタデータを作成する

  • mint_and_register_ip_with_terms : 規約付きでIPを登録する

設定

前提条件

  • Python 3.12以上

  • UV パッケージ マネージャー

インストール

  1. UV パッケージ マネージャーをインストールし、env をインストールします。

curl -LsSf https://astral.sh/uv/install.sh | sh

  1. このリポジトリをクローンします:

git clone https://github.com/piplabs/story-mcp-hub.git
cd story-mcp-hub

  1. UV を使用して依存関係をインストールします。

uv sync

  1. 各サーバーの環境変数を設定します。

StoryScan MCPの場合:

cd storyscan-mcp
cp .env.example .env
# Edit .env with your StoryScan API endpoint

Story SDK MCP の場合:

cd story-sdk-mcp
cp .env.example .env
# Edit .env with your wallet private key, RPC provider URL, etc.

サーバーの実行

StoryScan MCP サーバーインスペクター

cd storyscan-mcp
uv run mcp dev server.py

ストーリーSDK MCPサーバー

cd story-sdk-mcp
uv run mcp dev server.py

MCPクライアントでの使用

MCP サーバーをさまざまな MCP 互換クライアントに接続するには、以下の手順に従います。

カーソル

Cursor は、 stdioとsseトランスポートの両方を備えた任意の数の MCP サーバーをサポートする MCP クライアントを実装します。

カーソルにMCPサーバーを追加する

  1. Cursor Settings > Features > MCPに移動します

  2. + Add New MCP Serverボタンをクリックします。

  3. フォームに記入してください:

    • Typeでトランスポートを選択します

    • Nameフィールドにサーバーのニックネームを入力します

    • トランスポートに応じて、実行するコマンドまたはサーバーのURLを入力します。

    • サーバーを実行するにはuvコマンドを使用するので、サーバーへのパスに--directoryフラグを含めるようにしてください (例: uv --directory ~/path/to/story-mcp-hub/storyscan-mcp run server.py )

スクリーンショット 2025年3月10日 午後2時50分48秒

プロジェクト固有のMCP構成

.cursor/mcp.jsonを使用して、プロジェクト固有の MCP サーバーを設定できます。ファイルは次の形式に従います。

{
  "mcpServers": {
    "storyscan-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/path/to/story-mcp-hub/storyscan-mcp",
        "run",
        "server.py"
      ]
    },
    "story-sdk-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/path/to/story-mcp-hub/story-sdk-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

カーソルでのMCPツールの使用

Composer Agent は、MCP 設定ページの「 Available Toolsにリストされている MCP ツールが関連していると判断された場合、自動的に使用します。ツールの使用を意図的に促すには、ツール名または説明を指定して、エージェントにツールの使用を指示するだけです。

エージェントが MCP ツールを使用しようとすると、承認を求めるメッセージが表示されます。

クロードデスクトップ

Claude Desktop は、構成ファイルを編集することで MCP サーバーを使用するように構成できます。

Claude Desktop に MCP サーバーを追加する

  1. Claude Desktop 構成ファイルを開きます。

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

  1. MCP サーバー構成を追加します。

{
  "mcpServers": {
    "storyscan-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/path/to/story-mcp-hub/storyscan-mcp",
        "run",
        "server.py"
      ],
      // Add environment variables for the server
      "env": {
        "STORY_API_KEY": "your_story_api_key_here",
        "STORYSCAN_API_ENDPOINT": "your_story_api_endpoint_here"
      }
    },
    "story-sdk-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/path/to/story-mcp-hub/story-sdk-mcp",
        "run",
        "server.py"
      ],
      // Add environment variables for the server
      "env": {
        "WALLET_PRIVATE_KEY": "your_private_key_here",
        "RPC_PROVIDER_URL": "your_rpc_provider_url_here",
        "PINATA_JWT": "your_pinata_jwt_here"
      }
    }
  }
}

  1. 変更を有効にするには、ファイルを保存して Claude Desktop を再起動します。

スクリーンショット 2025-03-10 午後2時57分24秒

クエリ例: use storyscan to check balance of 0x95A13F457C76d10A40D7e8497eD4F40c53F4d04b

発達

新しい MCP サーバーをハブに追加するには:

  1. サーバーに新しいディレクトリを作成する

  2. サーバーにMCPプロトコルを実装する

  3. 必要な依存関係をルートpyproject.tomlに追加します。

  4. このREADMEをサーバの情報で更新してください

トラブルシューティング

問題が発生した場合:

  1. 各サーバーの環境変数が正しく設定されていることを確認します

  2. 外部 API (StoryScan、IPFS など) へのネットワーク接続を確認します

  3. 正しい Python バージョン (3.12 以上) を使用していることを確認してください

  4. uv syncですべての依存関係がインストールされていることを確認します

ライセンス

MITライセンス

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/piplabs/story-mcp-hub'

If you have feedback or need assistance with the MCP directory API, please join our Discord server