remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides tools to interact with IPFS storage, including uploading images and creating metadata

스토리 MCP 허브

이 저장소는 Story Protocol의 Model Context Protocol(MCP) 서버의 중앙 허브 역할을 합니다. AI 에이전트가 Story Protocol 생태계와 상호 작용할 수 있도록 다양한 MCP 서비스를 실행하고 관리하는 통합 환경을 제공합니다.

프로젝트 구조

지엑스피1

MCP 서버

StoryScan MCP 서버

주소 잔액, 거래, 블록체인 통계를 포함한 블록체인 데이터를 쿼리하기 위한 도구를 제공합니다.

도구:

check_balance : 주소의 잔액을 확인합니다.
get_transactions : 주소에 대한 최근 거래 내역을 가져옵니다.
get_stats : 현재 블록체인 통계를 가져옵니다.
get_address_overview : 주소에 대한 포괄적인 개요를 얻습니다.
get_token_holdings : 주소에 대한 모든 ERC-20 토큰 보유량을 가져옵니다.
get_nft_holdings : 주소에 대한 모든 NFT 보유량을 가져옵니다.
interpret_transaction : 거래에 대한 사람이 읽을 수 있는 해석을 가져옵니다.

스토리 SDK MCP 서버

Story Protocol의 Python SDK와 상호작용하기 위한 도구를 제공합니다.

도구:

get_license_terms : 특정 ID에 대한 라이선스 조건을 검색합니다.
mint_license_tokens : 특정 IP 및 라이선스 조건에 대한 Mint 라이선스 토큰
send_ip : 네이티브 토큰 전송을 사용하여 지정된 주소로 IP 토큰을 보냅니다.
upload_image_to_ipfs : IPFS에 이미지를 업로드하고 URI를 반환합니다.
create_ip_metadata : 특정 이미지 URI에 대한 NFT 메타데이터를 생성합니다.
mint_and_register_ip_with_terms : 조건에 따라 IP를 Mint하고 등록합니다.

설정

필수 조건

파이썬 3.12+
UV 패키지 관리자

설치

UV 패키지 관리자를 설치하고 env를 설치합니다.

curl -LsSf https://astral.sh/uv/install.sh | sh

이 저장소를 복제하세요:

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

UV를 사용하여 종속성을 설치합니다.

uv sync

각 서버에 대한 환경 변수를 설정합니다.

StoryScan MCP의 경우:

cd storyscan-mcp
cp .env.example .env
# Edit .env with your StoryScan API endpoint

Story SDK MCP의 경우:

cd story-sdk-mcp
cp .env.example .env
# Edit .env with your wallet private key, RPC provider URL, etc.

서버 실행

StoryScan MCP 서버 검사기

cd storyscan-mcp
uv run mcp dev server.py

스토리 SDK MCP 서버

cd story-sdk-mcp
uv run mcp dev server.py

MCP 클라이언트와 함께 사용

아래 지침에 따라 MCP 서버를 다양한 MCP 호환 클라이언트에 연결하세요.

커서

커서는 stdio 와 sse 전송을 모두 갖춘 임의의 수의 MCP 서버를 지원하는 MCP 클라이언트를 구현합니다.

커서에 MCP 서버 추가

Cursor Settings > Features > MCP 로 이동하세요.
+ Add New MCP Server 버튼을 클릭하세요
양식을 작성하세요:
- Type 에서 운송 수단을 선택하세요
- Name 필드에 서버의 별명을 입력하세요.
- 전송 방식에 따라 실행할 명령이나 서버의 URL을 입력하세요.
- uv 명령을 사용하여 서버를 실행하므로 서버 경로와 함께 --directory 플래그를 포함해야 합니다(예: 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"
      ]
    }
  }
}

커서에서 MCP 도구 사용

Composer Agent는 MCP 설정 페이지의 ' Available Tools 에 나열된 MCP 도구 중 관련성이 있다고 판단되는 도구를 자동으로 사용합니다. 도구 사용을 의도적으로 유도하려면 에이전트에게 도구 이름이나 설명을 언급하여 해당 도구를 사용하도록 지시하면 됩니다.

에이전트가 MCP 도구를 사용하려고 하면 승인을 요청하는 메시지가 표시됩니다.

클로드 데스크탑

Claude Desktop은 구성 파일을 편집하여 MCP 서버를 사용하도록 구성할 수 있습니다.

Claude Desktop에 MCP 서버 추가

Claude Desktop 구성 파일을 엽니다.

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

MCP 서버 구성을 추가합니다.

{
  "mcpServers": {
    "storyscan-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/path/to/story-mcp-hub/storyscan-mcp",
        "run",
        "server.py"
      ],
      // Add environment variables for the server
      "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"
      ],
      // Add environment variables for the server
      "env": {
        "WALLET_PRIVATE_KEY": "your_private_key_here",
        "RPC_PROVIDER_URL": "your_rpc_provider_url_here",
        "PINATA_JWT": "your_pinata_jwt_here"
      }
    }
  }
}

파일을 저장하고 Claude Desktop을 다시 시작하여 변경 사항을 적용하세요.

예제 쿼리: use storyscan to check balance of 0x95A13F457C76d10A40D7e8497eD4F40c53F4d04b

개발

허브에 새로운 MCP 서버를 추가하려면:

서버에 대한 새 디렉토리를 만듭니다.
서버에 MCP 프로토콜을 구현하세요
루트 pyproject.toml 에 필요한 종속성을 추가합니다.
이 README를 서버에 대한 정보로 업데이트하세요.

문제 해결

문제가 발생하는 경우:

각 서버에 대한 환경 변수가 올바르게 설정되었는지 확인하세요.
외부 API(StoryScan, IPFS 등)에 대한 네트워크 연결을 확인합니다.
올바른 Python 버전(3.12+)을 사용하고 있는지 확인하세요.
모든 종속성이 uv sync 로 설치되었는지 확인하세요.

특허

MIT 라이센스

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

IP 자산 및 라이선스 관리, Story Python SDK와의 상호 작용, 토큰 생성, IP 등록, IPFS에 메타데이터 업로드와 같은 작업 처리를 위한 도구를 제공합니다.

Related Resources

Reddit Discussion about this server

Story SDK MCP Server

Integrations

스토리 MCP 허브

프로젝트 구조

MCP 서버

StoryScan MCP 서버

스토리 SDK MCP 서버

설정

필수 조건

설치

서버 실행

StoryScan MCP 서버 검사기

스토리 SDK MCP 서버

MCP 클라이언트와 함께 사용

커서

커서에 MCP 서버 추가

프로젝트별 MCP 구성

커서에서 MCP 도구 사용

클로드 데스크탑

Claude Desktop에 MCP 서버 추가

개발

문제 해결

특허

Related Resources

Appeared in Searches