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 同步命令检查所有依赖项是否已正确安装。

📄 许可证

麻省理工学院许可证