Skip to main content
Glama
enesjakozh
piplabs

Story SDK MCP Server

by piplabs
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Historia MCP Hub

Este repositorio sirve como centro neurálgico para los servidores del Protocolo de Contexto de Modelo (MCP) de Story Protocol. Proporciona un entorno unificado para ejecutar y gestionar diversos servicios MCP que permiten a los agentes de IA interactuar con el ecosistema de Story Protocol.

Estructura del proyecto

story-mcp-hub/ ├── storyscan-mcp/ # MCP server for blockchain data queries via StoryScan ├── story-sdk-mcp/ # MCP server for Story Protocol SDK interactions ├── utils/ # Shared utilities for MCP servers ├── .venv/ # Python virtual environment ├── pyproject.toml # Project dependencies and configuration ├── .python-version # Python version specification └── README.md # This file
graph TD subgraph "MCP Hub" style MCP Hub fill:#F5F5FF,stroke:#9999CC,stroke-width:2px,rx:10,ry:10 Agent["AI Agent<br>(Claude, IDEs, Tools)"] style Agent fill:#E6E6FA,stroke:#9370DB,stroke-width:2px,rx:8,ry:8 end subgraph "StoryScan MCP Server" style StoryScan MCP Server fill:#F0F8FF,stroke:#87CEFA,stroke-width:2px,rx:10,ry:10 StoryscanService["StoryScan Service"] style StoryscanService fill:#E6E6FA,stroke:#9370DB,stroke-width:2px,rx:8,ry:8 subgraph "StoryScan Tools" style StoryScan Tools fill:#F0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:10,ry:10 StoryscanToolset["Balance & Stats<br>check_balance,<br>get_address_overview,<br>get_transactions,<br>interpret_transaction,<br>get_token_holdings,<br>get_nft_holdings,<br>get_stats"] style StoryscanToolset fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8 end end subgraph "Story SDK MCP Server" style Story SDK MCP Server fill:#F5FFFA,stroke:#98FB98,stroke-width:2px,rx:10,ry:10 StoryService["Story Service"] style StoryService fill:#E6E6FA,stroke:#9370DB,stroke-width:2px,rx:8,ry:8 subgraph "Story SDK Tools" style Story SDK Tools fill:#F0FFF0,stroke:#90EE90,stroke-width:2px,rx:10,ry:10 IPFSTools["IPFS Tools<br>upload_image_to_ipfs<br>create_ip_metadata"] style IPFSTools fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8 IPTools["IP Management Tools<br>mint_and_register_ip_with_terms<br>get_license_terms,<br>mint_license_tokens,<br>send_ip,<br>create_spg_nft_collection"] style IPTools fill:#E0FFFF,stroke:#5F9EA0,stroke-width:2px,rx:8,ry:8 end end subgraph "External Resources" style External Resources fill:#FFF0F5,stroke:#FFB6C1,stroke-width:2px,rx:10,ry:10 IPFS[(IPFS/Pinata<br>Storage)] style IPFS fill:#FFE4E1,stroke:#DB7093,stroke-width:2px,rx:15,ry:15 Blockchain[(Story Protocol<br>Blockchain)] style Blockchain fill:#E0F8E0,stroke:#90EE90,stroke-width:2px,rx:15,ry:15 StoryScan[(StoryScan/Blockscout<br>API)] style StoryScan fill:#E6F3FF,stroke:#87CEFA,stroke-width:2px,rx:15,ry:15 end Agent <--MCP Protocol--> StoryService Agent <--MCP Protocol--> StoryscanService StoryscanService --> StoryscanToolset StoryService --> IPFSTools StoryService --> IPTools StoryscanToolset <--API Calls--> StoryScan IPFSTools <--API Calls--> IPFS IPTools <--RPC Calls--> Blockchain

Related MCP server: Storybook MCP Server

Servidores MCP

Servidor StoryScan MCP

Proporciona herramientas para consultar datos de blockchain, incluidos saldos de direcciones, transacciones y estadísticas de blockchain.

Herramientas:

  • check_balance : Consultar el saldo de una dirección

  • get_transactions : Obtener transacciones recientes para una dirección

  • get_stats : Obtener estadísticas actuales de blockchain

  • get_address_overview : Obtenga una descripción general completa de una dirección

  • get_token_holdings : obtiene todas las tenencias de tokens ERC-20 para una dirección

  • get_nft_holdings : Obtener todas las existencias de NFT para una dirección

  • interpret_transaction : Obtener una interpretación legible por humanos de una transacción

Servidor MCP del SDK de Story

Proporciona herramientas para interactuar con el SDK de Python de Story Protocol.

Herramientas:

  • get_license_terms : recupera los términos de licencia para una identificación específica

  • mint_license_tokens : tokens de licencia de Mint para una IP específica y términos de licencia

  • send_ip : envía tokens IP a una dirección específica mediante transferencia de tokens nativa

  • upload_image_to_ipfs : Sube una imagen a IPFS y devuelve la URI

  • create_ip_metadata : crea metadatos NFT para una URI de imagen específica

  • mint_and_register_ip_with_terms : Crea y registra una IP con términos

Configuración

Prerrequisitos

  • Python 3.12+

  • Gestor de paquetes UV

Instalación

  1. Instalar el administrador de paquetes UV e instalar env:

curl -LsSf https://astral.sh/uv/install.sh | sh

  1. Clonar este repositorio:

git clone https://github.com/piplabs/story-mcp-hub.git cd story-mcp-hub

  1. Instalar dependencias usando UV:

uv sync

  1. Configurar variables de entorno para cada servidor:

Para StoryScan MCP:

cd storyscan-mcp cp .env.example .env # Edit .env with your StoryScan API endpoint

Para Story SDK MCP:

cd story-sdk-mcp cp .env.example .env # Edit .env with your wallet private key, RPC provider URL, etc.

Ejecución de los servidores

Inspector de servidor StoryScan MCP

cd storyscan-mcp uv run mcp dev server.py

Servidor MCP del SDK de Story

cd story-sdk-mcp uv run mcp dev server.py

Uso con clientes MCP

Siga las instrucciones a continuación para conectar los servidores MCP a varios clientes compatibles con MCP.

Cursor

Cursor implementa un cliente MCP que admite una cantidad arbitraria de servidores MCP con transportes stdio y sse .

Agregar servidores MCP en Cursor

  1. Vaya a Cursor Settings > Features > MCP

  2. Haga clic en el botón + Add New MCP Server

  3. Rellene el formulario:

    • Seleccione el transporte en Type

    • Introduzca un apodo para el servidor en el campo Name

    • Ingrese el comando a ejecutar o la URL del servidor, dependiendo del transporte

    • Usaremos el comando uv para ejecutar el servidor, así que asegúrese de incluir el indicador --directory con la ruta al servidor (Ejemplo: uv --directory ~/path/to/story-mcp-hub/storyscan-mcp run server.py )

Captura de pantalla del 10/03/2025 a las 14:50 y 48 h

Configuración de MCP específica del proyecto

Puedes configurar servidores MCP específicos del proyecto mediante .cursor/mcp.json . El archivo sigue este formato:

{ "mcpServers": { "storyscan-mcp": { "command": "uv", "args": [ "--directory", "~/path/to/story-mcp-hub/storyscan-mcp", "run", "server.py" ] }, "story-sdk-mcp": { "command": "uv", "args": [ "--directory", "~/path/to/story-mcp-hub/story-sdk-mcp", "run", "server.py" ] } } }

Uso de herramientas MCP en el cursor

El Agente de Composer usará automáticamente cualquier herramienta de MCP que aparezca en la sección Available Tools " de la página de configuración de MCP si la considera relevante. Para solicitar el uso de una herramienta, simplemente dígale al agente que la use, mencionando su nombre o descripción.

Cuando el Agente quiera utilizar una herramienta MCP, mostrará un mensaje solicitando su aprobación.

Escritorio de Claude

Claude Desktop se puede configurar para utilizar servidores MCP editando su archivo de configuración.

Cómo agregar servidores MCP en Claude Desktop

  1. Abra el archivo de configuración de Claude Desktop:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

  1. Agregue la configuración del servidor MCP:

{ "mcpServers": { "storyscan-mcp": { "command": "uv", "args": [ "--directory", "~/path/to/story-mcp-hub/storyscan-mcp", "run", "server.py" ], // Add environment variables for the server "env": { "STORY_API_KEY": "your_story_api_key_here", "STORYSCAN_API_ENDPOINT": "your_story_api_endpoint_here" } }, "story-sdk-mcp": { "command": "uv", "args": [ "--directory", "~/path/to/story-mcp-hub/story-sdk-mcp", "run", "server.py" ], // Add environment variables for the server "env": { "WALLET_PRIVATE_KEY": "your_private_key_here", "RPC_PROVIDER_URL": "your_rpc_provider_url_here", "PINATA_JWT": "your_pinata_jwt_here" } } } }

  1. Guarde el archivo y reinicie Claude Desktop para que los cambios surtan efecto.

Captura de pantalla 2025-03-10 a las 2 57 24PM

Ejemplo de consulta: use storyscan to check balance of 0x95A13F457C76d10A40D7e8497eD4F40c53F4d04b

Desarrollo

Para agregar un nuevo servidor MCP al concentrador:

  1. Crea un nuevo directorio para tu servidor

  2. Implemente el protocolo MCP en su servidor

  3. Agregue cualquier dependencia necesaria al archivo raíz pyproject.toml

  4. Actualice este README con información sobre su servidor

Solución de problemas

Si encuentra problemas:

  1. Verifique que las variables de entorno estén configuradas correctamente para cada servidor

  2. Verifique la conectividad de la red a las API externas (StoryScan, IPFS, etc.)

  3. Asegúrese de estar utilizando la versión correcta de Python (3.12+)

  4. Compruebe que todas las dependencias estén instaladas con uv sync

Licencia

Licencia MIT

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/piplabs/story-mcp-hub'

If you have feedback or need assistance with the MCP directory API, please join our Discord server