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 下開源。