Skip to main content
Glama

Story SDK MCP Server

by piplabs

ストーリー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

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 は、 stdiosseトランスポートの両方を備えた任意の数の 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ライセンス

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

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

IP 資産とライセンスを管理し、Story Python SDK と対話し、トークンの作成、IP の登録、IPFS へのメタデータのアップロードなどの操作を処理するためのツールを提供します。

  1. プロジェクト構造
    1. MCP サーバー
      1. StoryScan MCP サーバー
      2. ストーリーSDK MCPサーバー
    2. 設定
      1. 前提条件
      2. インストール
    3. サーバーの実行
      1. StoryScan MCP サーバーインスペクター
      2. ストーリーSDK MCPサーバー
    4. MCPクライアントでの使用
      1. カーソル
      2. クロードデスクトップ
    5. 発達
      1. トラブルシューティング
        1. ライセンス

          Related MCP Servers

          • -
            security
            F
            license
            -
            quality
            This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
            Last updated -
            Python
          • -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.
            Last updated -
            4
            Python
          • A
            security
            A
            license
            A
            quality
            A server that provides a persistent Python REPL environment through the MCP protocol, allowing execution of Python code, variable management, and package installation.
            Last updated -
            3
            3
            Python
            MIT License
          • -
            security
            A
            license
            -
            quality
            An MCP server that enables interaction with the Vercel API to manage deployments, DNS records, domains, projects, and environment variables through natural language commands.
            Last updated -
            65
            TypeScript
            MIT License

          View all related MCP servers

          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