Story Protocol SDK MCP

🚀 Story MCP Protocol

The Story MCP Protocol is a protocol designed for controlling music playback systems. With this protocol, you can remotely control various functions of music players, such as playing, pausing, and switching tracks.

🚀 Quick Start

The Story MCP Protocol allows you to remotely control music players. By following the installation and configuration steps, you can integrate this protocol into your music control system.

✨ Features

• Supports multiple music players (e.g., Spotify, Apple Music).
• Enables remote control over the network.
• Provides API interfaces for easy integration into other applications.

📦 Installation

Installation Steps

1. Download and install the Story MCP Protocol software package.
2. Configure the player to ensure it supports the MCP Protocol.
3. Run the Story MCP service.

Environment Requirements

• Operating System: Windows 10 or later, macOS 10.15 or later, or Linux (Ubuntu 20.04 or later).
• Network Environment: An internet connection is required to support the remote control function.
• Other Dependencies: Install Python 3.8 or later.

📚 Documentation

Configuration in Cursor

1. Open Cursor settings and go to "Features" > "MCP".
2. Click the "+ Add New MCP Server" button.
3. Fill in the form:
   • Select the transport type.
   • Enter the server name.
   • Enter the run command or URL.

Configuration in Claude Desktop

1. Open the Claude Desktop configuration file: code ~/Library/Application\ Support/Claude/claude_desktop_config.json
2. Add the MCP server configuration:

   {
     "mcpServers": {
       "storyscan-mcp": {
         "command": "uv",
         "args": [
           "--directory",
           "~/path/to/story-mcp-hub/storyscan-mcp",
           "run",
           "server.py"
         ],
         "env": {
           "STORY_API_KEY": "Your Story API Key",
           "STORYSCAN_API_ENDPOINT": "Your Story Scan API Endpoint"
         }
       },
       "story-sdk-mcp": {
         "command": "uv",
         "args": [
           "--directory",
           "~/path/to/story-mcp-hub/story-sdk-mcp",
           "run",
           "server.py"
         ],
         "env": {
           "WALLET_PRIVATE_KEY": "Your Private Key",
           "RPC_PROVIDER_URL": "Your RPC Provider URL",
           "PINATA_JWT": "Your Pinata JWT"
         }
       }
     }
   }
   

3. Save the file and restart Claude Desktop.

Development Guide

Adding a New MCP Server

1. Create a new directory to store your server code.
2. Implement the MCP Protocol in this directory.
3. Add the required dependencies to the pyproject.toml file in the root project.
4. Update this README document to add information about your server.

Troubleshooting

Common Issues

1. Environment Variable Setup: Ensure that all necessary environment variables are correctly set for each server.
2. Network Connection: Check if the network connection to external APIs (e.g., StoryScan, IPFS) is normal.
3. Python Version: Confirm that you are using a supported Python version (3.8 or later).
4. Dependency Installation: Use the uv sync command to check if all dependencies are correctly installed.

📄 License

MIT License