Story SDK MCP Server

@piplabs

代码仓库

基本信息

分类

开发工具

许可证

MIT

传输方式

stdio

作者

piplabs

关于 Story SDK MCP Server

An MCP server for the Story SDK and Storyscan Block Explorer

#story-protocol#mcp #sdk

Story SDK MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "story-sdk-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Story SDK MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Story SDK MCP Server?

Story SDK MCP Server provides tools that enable AI agents to interact with Story Protocol’s Python SDK. It handles IP asset registration, license management, royalty payments, NFT collection creation, and token operations through the Model Context Protocol.

How to use Story SDK MCP Server?

Install dependencies with uv sync, configure environment variables (wallet private key, RPC provider URL, optional PINATA_JWT for IPFS), then run uv run mcp dev server.py in the story-sdk-mcp directory. Connect to MCP clients like Cursor or Claude Desktop by adding the server as a stdio command using uv --directory <path> run server.py.

Key features of Story SDK MCP Server

IPFS & Metadata: upload images, create and upload IP metadata (requires PINATA_JWT)
License Management: get terms, mint license tokens, predict fees
IP Asset Management: register NFTs, attach license terms, mint and register with terms
NFT Collection Tools: create SPG NFT collections, get minting fee
Revenue & Royalty: pay royalties, claim all revenue from child IPs
Dispute & Token Tools: raise disputes, deposit/transfer WIP, check ERC20 balances, mint test ERC20 tokens

Use cases of Story SDK MCP Server

Register an NFT as an Intellectual Property asset on Story Protocol
Automate license token minting and royalty payment workflows
Create and manage SPG NFT collections for IP asset registration
Raise disputes against IP assets and claim revenue from child IPs

常见问题

What dependencies does Story SDK MCP Server require?

Python 3.12+, the UV package manager, and project dependencies installed via `uv sync`.

What environment variables are needed?

A wallet private key and RPC provider URL are required. For IPFS tools, a PINATA_JWT must also be set.

How does Story SDK MCP Server communicate with clients?

It uses the stdio transport of the Model Context Protocol (MCP). Clients such as Cursor and Claude Desktop invoke the server as a subprocess via a `uv` command.

What blockchain and storage does it interact with?

It makes RPC calls to the Story Protocol blockchain and API calls to IPFS (via Pinata) for metadata and image storage.

Are there known limitations?

IPFS tools require a valid Pinata JWT. The server uses a single wallet private key for all blockchain transactions; test tokens can be minted if the contract has a public mint/faucet function.

开发工具分类下的更多 MCP 服务器

LocalCan

Gives AI agents public URLs (tunnels) for localhost, live HTTP traffic inspection, snapshot publishing, and access control. Part of LocalCan, the ngrok alternative for Mac, Windows and Linux. Free plan.