Story MCP Hub

Story MCP Hub

site icon
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

基本能力

核心功能

  1. StoryScan MCP Server:
  2. check_balance: 检查地址余额
  3. get_transactions: 获取地址的最近交易
  4. get_stats: 获取当前区块链统计信息
  5. get_address_overview: 获取地址的全面概览
  6. get_token_holdings: 获取地址的所有 ERC-20 代币持有
  7. get_nft_holdings: 获取地址的所有 NFT 持有
  8. interpret_transaction: 获取交易的人类可读解释

  9. Story SDK MCP Server:

  10. get_license_terms: 检索特定 ID 的许可证条款
  11. mint_license_tokens: 为特定 IP 和许可证条款铸造许可证令牌
  12. send_ip: 使用原生代币转移将 IP 令牌发送到指定地址
  13. upload_image_to_ipfs: 将图像上传到 IPFS 并返回 URI
  14. create_ip_metadata: 为特定图像 URI 创建 NFT 元数据
  15. mint_and_register_ip_with_terms: 铸造并注册带有条款的 IP

使用场景

  • AI 代理与区块链数据的交互
  • 区块链开发者工具集成
  • IPFS 文件存储和管理
  • 知识产权(IP)管理和交易

使用教程

使用依赖

  • Python 3.12+
  • UV 包管理器

安装教程

  1. 安装 UV 包管理器:
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. 设置环境变量:
  2. 对于 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 等

调试方式

  1. 运行 StoryScan MCP Server:
cd storyscan-mcp
uv run mcp dev server.py
  1. 运行 Story SDK MCP Server:
cd story-sdk-mcp
uv run mcp dev server.py

常见问题解答

  1. 环境变量设置不正确: 确保每个服务器的环境变量已正确设置。
  2. 网络连接问题: 检查与外部 API(StoryScan、IPFS 等)的网络连接。
  3. Python 版本问题: 确保使用 Python 3.12+。
  4. 依赖安装问题: 使用 uv sync 确保所有依赖已安装。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。