Story Protocol

🚀 Introduction to Story MCP

Story MCP is a tool that provides specific services. This guide will introduce how to install, use, develop, and troubleshoot it.

🚀 Quick Start

📦 Installation Guide

Quick Installation of Story MCP

1. Clone the project repository:

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

2. Install dependencies:

   uv sync
   

3. Start the Story MCP service:

   uv run storyscan-mcp:server.py
   

💻 Usage Examples

Adding a Story MCP Server in Cursor

1. Open Cursor settings > Features > MCP.
2. Click the "+ Add New MCP Server" button.
3. Fill out the form:
   • Select the transport type.
   • Enter the server name.
   • Enter the run command or URL (e.g., uv --directory ~/path/to/story-mcp-hub/storyscan-mcp run server.py).

Project-Specific MCP Configuration

You can configure project-specific MCP servers in the .cursor/mcp.json file:

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

Configuring an MCP Server in Claude Desktop

1. Open the Claude Desktop configuration file:

   code ~/Library/Application\ 支持/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_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"
      }
    }
  }
}

📚 Documentation

Development Guide for Story MCP

1. Create a new server directory.
2. Implement the MCP protocol.
3. Update the dependencies in the root pyproject.toml file.
4. Add information about the new server in this README.

Troubleshooting for Story MCP

1. Verify that the environment variables are set correctly.
2. Check the network connection to external APIs (e.g., StoryScan, IPFS, etc.).
3. Ensure that the correct Python version (3.12+) is used.
4. Check the command syntax and paths.

📄 License

The project is open-source under the LICENSE.