
Story MCP Hub

2025.03.23
11
Python区块链服务AI 代理工具IPFS 管理知识产权管理金融服务开发效率
Story MCP Hub 是 Story Protocol 的 Model Context Protocol (MCP) 服务器的中心枢纽,为运行和管理各种 MCP 服务提供统一环境,使 AI 代理能够与 Story Protocol 的生态系统进行交互。
### 核心功能
1. **StoryScan MCP Server**: 提供查询区块链数据的工具,包括地址余额、交易和区块链统计信息。
2. **Story SDK MCP Server**: 提供与 Story Protocol 的 Python SDK 交互的工具,包括 IPFS 上传、IP 管理和许可证令牌铸造等。
### 适用场景
- AI 代理与区块链数据的交互
- 区块链开发者工具集成
- IPFS 文件存储和管理
- 知识产权(IP)管理和交易
View on GitHub
Overview
基本能力
核心功能
- 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 包管理器:
curl -LsSf https://astral.sh/uv/install.sh | sh
- 克隆仓库:
git clone https://github.com/piplabs/story-mcp-hub.git
cd story-mcp-hub
- 使用 UV 安装依赖:
uv sync
- 设置环境变量:
- 对于 StoryScan MCP:
cd storyscan-mcp
cp .env.example .env
# 编辑 .env 文件,填写 StoryScan API 端点
- 对于 Story SDK MCP:
cd story-sdk-mcp
cp .env.example .env
# 编辑 .env 文件,填写钱包私钥、RPC 提供者 URL 等
调试方式
- 运行 StoryScan MCP Server:
cd storyscan-mcp
uv run mcp dev server.py
- 运行 Story SDK MCP Server:
cd story-sdk-mcp
uv run mcp dev server.py
常见问题解答
- 环境变量设置不正确: 确保每个服务器的环境变量已正确设置。
- 网络连接问题: 检查与外部 API(StoryScan、IPFS 等)的网络连接。
- Python 版本问题: 确保使用 Python 3.12+。
- 依赖安装问题: 使用
uv sync
确保所有依赖已安装。