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

许可证

麻省理工学院许可证