Skip to main content
Glama
Sign In
enesjakozh

Story SDK MCP Server

Official
by piplabs
GitHub
Python
MIT License
11
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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.

Integrations

  • Provides tools to interact with IPFS storage, including uploading images and creating metadata

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

プロジェクト固有の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 を再起動します。

クエリ例: 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

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

  1. Project Structure
    1. MCP Servers
      1. StoryScan MCP Server
      2. Story SDK MCP Server
    2. Setup
      1. Prerequisites
      2. Installation
    3. Running the Servers
      1. StoryScan MCP Server Inspector
      2. Story SDK MCP Server
    4. Using with MCP Clients
      1. Cursor
      2. Claude Desktop
    5. Development
      1. Troubleshooting
        1. License

          Related Resources

          Appeared in Searches

          ID: amg3ohg7vs