Skip to main content
Glama
Sign In
enesjakozh

Story SDK MCP Server

by piplabs
GitHub
Python
MIT License
11
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Integrations

  • Provides tools to interact with IPFS storage, including uploading images and creating metadata

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

  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 )

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.

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

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.

  1. Estructura del proyecto
    1. Servidores MCP
      1. Servidor StoryScan MCP
      2. Servidor MCP del SDK de Story
    2. Configuración
      1. Prerrequisitos
      2. Instalación
    3. Ejecución de los servidores
      1. Inspector de servidor StoryScan MCP
      2. Servidor MCP del SDK de Story
    4. Uso con clientes MCP
      1. Cursor
      2. Escritorio de Claude
    5. Desarrollo
      1. Solución de problemas
        1. Licencia

          Related Resources

          Related MCP Servers

          • Lodestar MCP Server

            kanlanc
            -
            security
            F
            license
            -
            quality
            This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
            Last updated -
            Python

          • Blender MCP Server

            cwahlfeldt
            -
            security
            F
            license
            -
            quality
            A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.
            Last updated -
            4
            Python

          • Python REPL MCP Server

            hdresearch
            A
            security
            A
            license
            A
            quality
            A server that provides a persistent Python REPL environment through the MCP protocol, allowing execution of Python code, variable management, and package installation.
            Last updated -
            3
            3
            Python
            MIT License

          • Vercel API MCP Server

            ssdavidai
            -
            security
            A
            license
            -
            quality
            An MCP server that enables interaction with the Vercel API to manage deployments, DNS records, domains, projects, and environment variables through natural language commands.
            Last updated -
            60
            TypeScript
            MIT License

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          ID: amg3ohg7vs