基本能力
核心功能
- StoryScan MCP Server:
check_balance
: 检查地址余额get_transactions
: 获取地址的最近交易get_stats
: 获取当前区块链统计信息get_address_overview
: 获取地址的全面概览get_token_holdings
: 获取地址的所有 ERC-20 代币持有get_nft_holdings
: 获取地址的所有 NFT 持有-
interpret_transaction
: 获取交易的人类可读解释 -
Story SDK MCP Server:
get_license_terms
: 检索特定 ID 的许可证条款mint_license_tokens
: 为特定 IP 和许可证条款铸造许可证令牌send_ip
: 使用原生代币转移将 IP 令牌发送到指定地址upload_image_to_ipfs
: 将图像上传到 IPFS 并返回 URIcreate_ip_metadata
: 为特定图像 URI 创建 NFT 元数据mint_and_register_ip_with_terms
: 铸造并注册带有条款的 IP
使用场景
- AI 代理与区块链数据的交互
- 区块链开发者工具集成
- IPFS 文件存储和管理
- 知识产权(IP)管理和交易
使用教程
使用依赖
- Python 3.12+
- UV 包管理器
安装教程
-
安装 UV 包管理器:
bash
curl -LsSf https://astral.sh/uv/install.sh | sh -
克隆仓库:
bash
git clone https://github.com/piplabs/story-mcp-hub.git
cd story-mcp-hub -
使用 UV 安装依赖:
bash
uv sync -
设置环境变量:
- 对于 StoryScan MCP:
```bash
cd storyscan-mcp
cp .env.example .env
编辑 .env 文件,填写 StoryScan API 端点
- 对于 Story SDK MCP:
bash
cd story-sdk-mcp
cp .env.example .env
编辑 .env 文件,填写钱包私钥、RPC 提供者 URL 等
```
调试方式
-
运行 StoryScan MCP Server:
bash
cd storyscan-mcp
uv run mcp dev server.py -
运行 Story SDK MCP Server:
bash
cd story-sdk-mcp
uv run mcp dev server.py
常见问题解答
- 环境变量设置不正确: 确保每个服务器的环境变量已正确设置。
- 网络连接问题: 检查与外部 API(StoryScan、IPFS 等)的网络连接。
- Python 版本问题: 确保使用 Python 3.12+。
- 依赖安装问题: 使用
uv sync
确保所有依赖已安装。