Story Protocol

🚀 故事 MCP 介绍

故事 MCP 是一个具备特定功能的项目，为用户提供了一系列服务。下面将详细介绍其安装、使用、开发等方面的内容。

🚀 快速开始

故事 MCP 能为用户带来便捷的服务体验，通过以下步骤你可以快速开启使用之旅。

📦 安装指南

故事 MCP 快速安装

按照以下步骤可以快速完成故事 MCP 的安装：

1. 克隆项目仓库：

   git clone https://github.com/your-repository.git
   cd story-mcp-hub
   

2. 安装依赖项：

   uv sync
   

3. 启动故事 MCP 服务：

   uv run storyscan-mcp:server.py
   

💻 使用示例

基础用法

在 Cursor 中添加故事 MCP 服务器

1. 打开 Cursor 设置 > 特性 > MCP。
2. 点击“+ 添加新 MCP 服务器”按钮。
3. 填写表单：
   • 选择传输类型
   • 输入服务器名称
   • 输入运行命令或 URL（例如：uv --directory ~/path/to/story-mcp-hub/storyscan-mcp run server.py）

项目专用 MCP 配置

可以在 .cursor/mcp.json 文件中配置项目特定的 MCP 服务器：

{
  "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"
      ]
    }
  }
}

在 Claude 桌面版中配置 MCP 服务器

1. 打开 Claude 桌面版配置文件：

   code ~/Library/Application\ 支持/Claude/claude_desktop_config.json
   

2. 添加 MCP 服务器配置：

{
  "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_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"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "your_private_key_here",
        "RPC_PROVIDER_URL": "your_rpc_provider_url_here",
        "PINATA_JWT": "your_pinata_jwt_here"
      }
    }
  }
}

📚 详细文档

故事 MCP 开发指南

如果你想参与故事 MCP 的开发，可以按照以下步骤进行：

1. 创建新服务器目录
2. 实现 MCP 协议
3. 更新根 pyproject.toml 文件中的依赖项
4. 在本 README 中添加有关新服务器的信息

故事 MCP 故障排除

当遇到问题时，可以参考以下故障排除步骤：

1. 验证环境变量是否正确设置
2. 检查与外部 API（如 StoryScan、IPFS 等）的网络连接
3. 确保使用正确的 Python 版本（3.12+）
4. 检查命令语法和路径

📄 许可证

项目在 LICENSE 下开源。