Storacha MCP Storage Server

Storacha MCP 스토리지 서버

Storacha 핫 스토리지를 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현으로, AI 애플리케이션이 표준화된 인터페이스를 통해 파일을 저장하고 검색할 수 있도록 지원합니다. IPFS 및 CID를 사용하여 신뢰할 수 있는 분산형 데이터 교환을 지원하여 데이터 주권, 검증 가능성, 에이전트 프레임워크 및 AI 시스템과의 원활한 통합을 보장합니다.

무료 저장 옵션으로 시작하세요 🚀

지금 당장 분산형 스토리지 여정을 시작하세요!

• GitHub 사용자 : GitHub 계정으로 가입하면 즉시 100MB의 무료 저장공간 을 받으실 수 있습니다. 신용카드는 필요하지 않습니다!
• 이메일 사용자 : 이메일로 등록하고 신용카드를 등록하면 5GB의 무료 저장 공간을 이용하실 수 있습니다.

사용 사례

• 문서 저장 및 분석 : Blob 문서를 안전하게 업로드하고 검색합니다.
• 장기 구조화된 데이터 저장 : 장수명과 접근성을 위해 최적화된 구조화된 데이터 저장을 유지합니다.
• 에이전트와 시스템 간 데이터 공유 : CID(콘텐츠 식별자)를 사용하여 여러 에이전트와 다양한 시스템에서 데이터를 쉽게 공유하여 분산되고 검증 가능하며 효율적인 데이터 교환을 구현합니다.
• 애플리케이션 통합 : Model Context Protocol을 통해 Storacha 스토리지 검색을 애플리케이션에 원활하게 통합합니다.
• AI 모델 개발 : Storacha에 저장된 외부 데이터 세트에 대한 안정적인 버전 관리 및 액세스를 제공하여 AI 모델을 지원합니다.
• LLM 통합 : 원활한 데이터 액세스를 위해 Storacha Storage에 직접 연결하여 대규모 언어 모델(LLM)을 향상시킵니다.
• 웹 애플리케이션 백업 : 재해 복구를 위해 웹 애플리케이션의 백업 사본을 안정적으로 저장합니다.
• 머신 러닝 데이터 세트 : 머신 러닝 워크플로에 사용되는 대규모 데이터 세트를 효율적으로 관리하고 액세스합니다.

빠른 설치 가이드

간단한 몇 단계만으로 Storacha MCP 스토리지 서버를 시작해 보세요.

1. 저장소 복제지엑스피1
2. 종속성 설치
   pnpm install
3. 키 및 위임 생성
   • CLI 설치
     npm install -g @web3-storage/w3cli
   • Storacha에 로그인하세요
     w3 login
     산출:
     ? How do you want to login? Via Email ❯ Via GitHub
     'GitHub를 통해'를 선택하고 GitHub 계정으로 인증하세요.
   • 공간 만들기
     w3 space create <your_space_name>
     <your_space_name> 새 공간의 이름으로 바꾸세요 . : 필요한 경우 다른 기기에서 공간에 액세스할 수 있도록 복구 키를 저장하세요.
   • 개인 키 생성
     w3 key create
     산출:
     AgentId: did:key:z6MkhMZRW2aoJ6BQwkpMSJu68Jgqkz1FTpr1p69cpnN43YWG PrivateKey: LMgCYLkvOc8Sm0mOL4cWFLxsWP0ZPEYrLxcQqsV93/s5RLje0BKx05muAse1Hkvh+sxUW38OcHtpiN1zxfpTJ4ht4jxV0=
   • 에이전트 ID 설정 및 위임 생성
     w3 delegation create <agent_id> \ --can 'store/add' \ --can 'filecoin/offer' \ --can 'upload/add' \ --can 'space/blob/add' \ --can 'space/index/add' --base64
     <agent_id>를 이전 단계의 AgentId로 바꾸세요. 이렇게 하면 Agent가 최근에 생성된 공간에 파일을 저장할 수 있는 권한을 부여합니다 .
4. MCP 클라이언트 구성다음으로, 이 서버를 사용하도록 MCP 클라이언트(예: Cursor)를 구성합니다. 대부분의 MCP 클라이언트는 구성을 다음 형식의 JSON으로 저장합니다.
   { "mcpServers": { "storacha-storage-server": { "command": "node", "args": ["./dist/index.js"], "env": { // The server supports `stdio`, `sse`, and `rest` modes, the default is `stdio`. "MCP_TRANSPORT_MODE": "stdio", // The Storacha Agent private key that is authorized to store data into the Space. "PRIVATE_KEY": "<agent_private_key>", // The base64 encoded delegation that proves the Agent is allowed to store data. If not set, MUST be provided for each upload request. "DELEGATION": "<base64_delegation>", }, "shell": true, "cwd": "./", }, }, }
   <agent_private_key> 3단계에서 만든 PrivateKey로 바꾸세요. 그런 다음, <base64_delegation> 을 3단계에서 만든 위임으로 바꾸세요.

REST 모드 및 클라우드 호스팅

Storacha MCP 스토리지 서버는 MCP.so 클라우드 호스팅과 호환되는 REST 전송 모드를 지원합니다. REST 모드를 사용하려면:

MCP.so 클라우드에 배포하는 방법에 대한 자세한 내용은 integrations.md 가이드를 참조하세요.

:경고: MCP 클라이언트를 구성하는 방법은 여러 가지가 있습니다. 자세한 내용은 integrations.md 가이드를 참조하세요.

도구

Storacha MCP 스토리지 서버는 AI 시스템이 분산 스토리지 네트워크와 상호 작용할 수 있도록 다음과 같은 도구를 제공합니다.

저장 작업

업로드하다

Storacha 네트워크에 파일을 업로드하세요. MIME 유형 감지를 위해 파일 이름은 base64로 인코딩된 문자열이어야 하며, 파일 확장자가 포함되어야 합니다.

검색하다

Storacha 네트워크에서 파일을 검색합니다. 지원되는 파일 경로 형식은 CID/filename , /ipfs/CID/filename 또는 ipfs://CID/filename .

신원

개인 키 저장소 구성에서 로드된 Storacha Agent의 DIDKey 반환합니다.

자세한 코드 예제와 다양한 통합 패턴(SDK, Docker 등)은 integrations.md 가이드를 참조하세요.

특허

MIT 또는 Apache 2 라이센스

지원하다

지원이 필요하면 Storacha 지원을 방문하거나 이 저장소에서 문제를 열어주세요.