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 開発ガイド

1. 新しいサーバーディレクトリを作成します。
2. MCP プロトコルを実装します。
3. ルートの pyproject.toml ファイルの依存関係を更新します。
4. この README に新しいサーバーに関する情報を追加します。

ストーリー MCP のトラブルシューティング

1. 環境変数が正しく設定されていることを確認します。
2. 外部 API（StoryScan、IPFS など）とのネットワーク接続を確認します。
3. 正しい Python バージョン（3.12+）を使用していることを確認します。
4. コマンドの構文とパスを確認します。

📄 ライセンス

このプロジェクトは LICENSE の下でオープンソースとして提供されています。