Servidor MCP del SDK de Story

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

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

Instalar el administrador de paquetes UV e instalar env:

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

Clonar este repositorio:

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

Instalar dependencias usando UV:

uv sync

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

Vaya a Cursor Settings > Features > MCP
Haga clic en el botón + Add New MCP Server
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

Abra el archivo de configuración de Claude Desktop:

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

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"
      }
    }
  }
}

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:

Crea un nuevo directorio para tu servidor
Implemente el protocolo MCP en su servidor
Agregue cualquier dependencia necesaria al archivo raíz pyproject.toml
Actualice este README con información sobre su servidor

Solución de problemas

Si encuentra problemas:

Verifique que las variables de entorno estén configuradas correctamente para cada servidor
Verifique la conectividad de la red a las API externas (StoryScan, IPFS, etc.)
Asegúrese de estar utilizando la versión correcta de Python (3.12+)
Compruebe que todas las dependencias estén instaladas con uv sync

Licencia

Licencia MIT

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Proporciona herramientas para administrar activos y licencias de IP, interactuar con Story Python SDK y manejar operaciones como acuñar tokens, registrar IP y cargar metadatos a IPFS.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Xcode MCP Server
devyhan
A
security
A
license
A
quality
A Model Context Protocol server that provides tools for Xcode-related operations, making it easier to work with iOS project management, building, testing, archiving, and deploying apps to both simulators and physical devices.
Last updated -
9
43
JavaScript
MIT License
Storybook MCP Server
m-yoshiro
A
security
A
license
A
quality
A Model Context Protocol server that integrates with Storybook to help AI tools query UI components and retrieve usage examples from static Storybook files.
Last updated -
2
JavaScript
MIT License
DeepWriter MCP Serverofficial
deepwriter-ai
A
security
A
license
A
quality
Provides tools for creating, managing, and generating content for DeepWriter projects through a standardized Model Context Protocol interface.
Last updated -
6
5
TypeScript
Apache 2.0
Storyblok MCP Server
Kiran1689
-
security
A
license
-
quality
The Storyblok MCP server enables your AI assistants to directly access and manage your Storyblok spaces, stories, components, assets, workflows, and more.
Last updated -
14
Python
MIT License

View all related MCP servers

Story SDK MCP Server

Historia MCP Hub

Estructura del proyecto

Servidores MCP

Servidor StoryScan MCP

Servidor MCP del SDK de Story

Configuración

Prerrequisitos

Instalación

Ejecución de los servidores

Inspector de servidor StoryScan MCP

Servidor MCP del SDK de Story

Uso con clientes MCP

Cursor

Agregar servidores MCP en Cursor

Configuración de MCP específica del proyecto

Uso de herramientas MCP en el cursor

Escritorio de Claude

Cómo agregar servidores MCP en Claude Desktop

Desarrollo

Solución de problemas

Licencia

Related Resources

Related MCP Servers

Xcode MCP Server

Storybook MCP Server

DeepWriter MCP Serverofficial

Storyblok MCP Server

Appeared in Searches

New MCP Servers

MCP directory API