Story Protocol SDK MCP

🚀 故事MCP協議

故事MCP協議是用於控制音樂播放系統的協議。藉助該協議，你能遠程操控音樂播放器的各類功能，像播放、暫停、切換曲目等，為音樂播放控制帶來極大便利。

🚀 快速開始

故事MCP協議可讓你輕鬆實現對音樂播放器的遠程控制。你只需按照以下步驟操作，就能快速開啟使用之旅。

✨ 主要特性

• 支持多種音樂播放器（如Spotify, Apple Music），適用性廣泛。
• 可通過網絡進行遠程控制，突破空間限制。
• 提供API接口，便於集成到其他應用程序中，拓展性強。

📦 安裝指南

安裝步驟

1. 下載並安裝故事MCP協議的軟件包。
2. 配置播放器，確保其支持MCP協議。
3. 運行故事MCP服務。

環境要求

• 操作系統：Windows 10及以上版本、macOS 10.15及以上版本或Linux（Ubuntu 20.04及以上）。
• 網絡環境：需要互聯網連接以支持遠程控制功能。
• 其他依賴：安裝Python 3.8及以上版本。

📚 詳細文檔

配置指南

在Cursor中的配置

1. 打開Cursor設置，進入“特性” > “MCP”。
2. 點擊“+ 添加新MCP服務器”按鈕。
3. 填寫表單：
   • 選擇傳輸類型。
   • 輸入服務器名稱。
   • 輸入運行命令或URL。

在Claude Desktop中的配置

1. 打開Claude Desktop的配置文件：code ~/Library/Application\ 支持/Claude/claude_desktop_config.json。
2. 添加MCP服務器配置：

{
    "mcpServers": {
        "storyscan-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "~/路徑/to/story-mcp-hub/storyscan-mcp",
                "運行",
                "server.py"
            ],
            "env": {
                "STORY_API_KEY": "你的故事API密鑰",
                "STORYSCAN_API_ENDPOINT": "你的故事掃描API端點"
            }
        },
        "story-sdk-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "~/路徑/to/story-mcp-hub/story-sdk-mcp",
                "運行",
                "server.py"
            ],
            "env": {
                "WALLET_PRIVATE_KEY": "你的私鑰",
                "RPC_PROVIDER_URL": "你的RPC提供者URL",
                "PINATA_JWT": "你的Pinata JWT"
            }
        }
    }
}

3. 保存文件並重啟Claude Desktop。

開發指南

添加新MCP服務器

1. 創建一個新的目錄用於存放你的服務器代碼。
2. 在該目錄中實現MCP協議。
3. 將所需的依賴項添加到根項目的pyproject.toml文件中。
4. 更新本README文檔，添加關於你服務器的信息。

故障排除

常見問題

1. 環境變量設置：確保為每個服務器正確設置了所有必要的環境變量。
2. 網絡連接：檢查到外部API（如StoryScan、IPFS）的網絡連接是否正常。
3. Python版本：確認使用的是支持的Python版本（3.8及以上）。
4. 依賴項安裝：使用uv 同步命令檢查所有依賴項是否已正確安裝。

📄 許可證

麻省理工學院許可證