story mcp hub

关键词

区块链数据查询Story Protocol SDKIPFSNFTWeb3

使用说明

项目简介

Story MCP Hub 是一个中心化的仓库，用于运行和管理多个为 AI 智能体提供与 Story Protocol 生态系统交互能力的 MCP (Model Context Protocol) 服务器。该 Hub 包含 StoryScan MCP 服务器和 Story SDK MCP 服务器，分别提供区块链数据查询和 Story Protocol SDK 交互的功能。

主要功能点

  • StoryScan MCP 服务器:
    • 提供 StoryScan 服务的工具，用于查询 Story Protocol 区块链上的数据。
    • 功能包括查询地址余额、交易记录、区块链统计信息等。
  • Story SDK MCP 服务器:
    • 提供 Story Protocol Python SDK 的工具，用于与 Story Protocol 进行更深入的交互。
    • 功能包括 IPFS 文件上传、IP 资产元数据创建、许可条款管理、IP 资产和许可 Token 的铸造与发送、SPG NFT 合集创建等。

安装步骤

  1. 安装 UV 包管理器: 复制并执行以下命令安装 UV 包管理器。 
    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. 克隆仓库: 复制仓库地址并克隆到本地。 
    git clone https://github.com/piplabs/story-mcp-hub.git
cd story-mcp-hub
  3. 安装依赖: 使用 UV 包管理器安装项目依赖。 
    uv sync
  4. 配置环境变量: 根据需要配置 StoryScan MCP 和 Story SDK MCP 服务器的环境变量。
    • StoryScan MCP 服务器: 
      cd storyscan-mcp
cp .env.example .env
# 编辑 .env 文件，设置 StoryScan API Endpoint (STORYSCAN_API_ENDPOINT)
    • Story SDK MCP 服务器: 
      cd story-sdk-mcp
cp .env.example .env
# 编辑 .env 文件，设置钱包私钥 (WALLET_PRIVATE_KEY)、RPC provider URL (RPC_PROVIDER_URL) 等

服务器配置

以下是在 MCP 客户端 (如 Cursor, Claude Desktop) 中配置 StoryScan MCP 服务器和 Story SDK MCP 服务器的示例配置信息。客户端需要配置服务器的启动命令及其参数，以便连接到 MCP 服务器。

  • StoryScan MCP 服务器配置
{
  "server name": "storyscan-mcp",
  "command": "uv",
  "args": [
    "--directory",
    "~/path/to/story-mcp-hub/storyscan-mcp",  //  请替换为 story-mcp-hub/storyscan-mcp 目录的实际路径
    "run",
    "server.py"
  ]
}
  • Story SDK MCP 服务器配置
{
  "server name": "story-sdk-mcp",
  "command": "uv",
  "args": [
    "--directory",
    "~/path/to/story-mcp-hub/story-sdk-mcp",  //  请替换为 story-mcp-hub/story-sdk-mcp 目录的实际路径
    "run",
    "server.py"
  ]
}

基本使用方法

  1. 启动 MCP 服务器: 根据 "运行服务器" 章节的指引，分别启动 StoryScan MCP 服务器和 Story SDK MCP 服务器。
    • StoryScan MCP 服务器: 
      cd storyscan-mcp
uv run mcp dev server.py
    • Story SDK MCP 服务器: 
      cd story-sdk-mcp
uv run mcp dev server.py
  2. 在 MCP 客户端中使用工具: 在兼容 MCP 协议的客户端 (如 Cursor 或 Claude Desktop) 中配置并连接到已启动的 MCP 服务器后，即可在客户端中使用 MCP 服务器提供的工具。例如：
    • 在 Cursor 中，可以通过在聊天框中输入指令来调用工具，例如 'use storyscan to check balance of 0x95A13F457C76d10A40D7e8497eD4F40c53F4d04b'。
    • 在 Claude Desktop 中，可以使用类似的指令，例如 'use storyscan to check balance of 0x95A13F457C76d10A40D7e8497eD4F40c53F4d04b'。
    • 具体工具的使用方法可以参考每个工具的描述 (在 'server.py' 文件中定义)。

服务器信息

访问项目