mcp-ipfs

🪐 MCP IPFS 서버(storacha.network) 🛰️

w3 명령줄 인터페이스( @web3-storage/w3cli )를 통해 storacha.network 플랫폼과 상호작용하기 위한 모델 컨텍스트 프로토콜(MCP)을 구현하는 Node.js 서버입니다.

이 서버는 언어 모델🤖 및 기타 MCP 클라이언트가 storacha.network 공간을 관리하고, 데이터를 업로드/다운로드하고, 위임을 관리하고, w3 명령을 원활하게 래핑하여 다양한 다른 작업을 수행할 수 있도록 지원합니다.

✨ 특징

• storacha.network와의 기본 통합을 위해 w3 CLI를 래핑합니다.
• 광범위한 w3 기능을 포괄하는 MCP 도구를 제공합니다.
  • 🔑 인증 및 에이전트: w3_login , w3_reset , w3_account_ls (권한 확인용)
  • 📦 공간 관리: w3_space_ls , w3_space_use , w3_space_info , w3_space_add , w3_space_provision (참고: 대화형 프롬프트로 인해 w3_space_create 수동으로 실행해야 함)
  • 💾 데이터 관리: w3_up , w3_ls , w3_rm
  • 🔗 공유: w3_open (w3s.link URL 생성)
  • 🤝 위임 및 증명: w3_delegation_create , w3_delegation_ls , w3_delegation_revoke , w3_proof_add , w3_proof_ls
  • 🔐 키 및 토큰: w3_key_create , w3_bridge_generate_tokens
  • ⚙️ 고급 저장소( w3 can ... ): Blob, CAR, 업로드, 인덱스, 액세스 클레임, Filecoin 정보 관리
  • 💳 계정 및 청구: w3_plan_get , w3_coupon_create , w3_usage_report

🛠️ 필수 조건

• Node.js: 버전 22.0.0 이상( node -v ).
• w3 CLI: 서버가 w3 명령을 직접 실행합니다. @web3-storage/w3cli 전역으로 설치되고 구성되어 있는지 확인하세요.지엑스피1
• 환경 변수: w3_login 도구를 사용하려면 W3_LOGIN_EMAIL 환경 변수를 w3 login 에 사용된 이메일과 동일하게 설정해야 합니다.

🏗️ 프로젝트 구조

코드베이스는 다음과 같이 구성됩니다.

🚀 MCP 클라이언트와 함께 사용

이 서버는 모든 MCP 호환 클라이언트와 함께 사용할 수 있습니다. 이 서버에 연결하려면 클라이언트를 구성해야 합니다.

예: NPX(간단한 로컬 사용에 권장)

이는 npm 과 전제 조건이 충족된다고 가정합니다.

예: Docker

먼저 이미지를 빌드하세요(빌드 섹션 참조) 또는 미리 빌드된 이미지 alexbakers/mcp-ipfs 사용하세요.

📝 경로에 대한 참고 사항:

몇몇 w3 명령에는 절대 파일 시스템 경로가 필요합니다(예: w3_up , w3_delegation_create --output , w3_proof_add , w3_can_blob_add , w3_can_store_add ).

• NPX: 호스트 머신에서의 절대 경로를 제공합니다.
• Docker: 컨테이너 내부의 절대 경로를 제공하세요. 호스트에서 파일을 사용하는 경우(예: 업로드) -v 플래그(예: -v /Users/me/project:/Users/me/project )를 사용하여 해당 호스트 디렉터리 를 컨테이너에 마운트한 다음, 도구 인수에 컨테이너 경로 (예: /Users/me/project/my_file.txt )를 사용해야 합니다.

📦 빌드

저장소를 복제하고 종속성을 설치합니다.

TypeScript 코드를 작성합니다.

그런 다음 서버를 직접 실행할 수 있습니다.

또는 (권한이 있는 경우) 게시하세요:

🐳 도커 빌드

Docker 이미지를 빌드합니다.

📜 라이센스

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.