๐ช MCP IPFS ์๋ฒ(storacha.network) ๐ฐ๏ธ

w3 ๋ช
๋ น์ค ์ธํฐํ์ด์ค( @web3-storage/w3cli )๋ฅผ ํตํด storacha.network ํ๋ซํผ๊ณผ ์ํธ์์ฉํ๊ธฐ ์ํ ๋ชจ๋ธ ์ปจํ
์คํธ ํ๋กํ ์ฝ(MCP)์ ๊ตฌํํ๋ Node.js ์๋ฒ์
๋๋ค.
์ด ์๋ฒ๋ ์ธ์ด ๋ชจ๋ธ๐ค ๋ฐ ๊ธฐํ MCP ํด๋ผ์ด์ธํธ๊ฐ storacha.network ๊ณต๊ฐ์ ๊ด๋ฆฌํ๊ณ , ๋ฐ์ดํฐ๋ฅผ ์
๋ก๋/๋ค์ด๋ก๋ํ๊ณ , ์์์ ๊ด๋ฆฌํ๊ณ , w3 ๋ช
๋ น์ ์ํํ๊ฒ ๋ํํ์ฌ ๋ค์ํ ๋ค๋ฅธ ์์
์ ์ํํ ์ ์๋๋ก ์ง์ํฉ๋๋ค.
โจ ํน์ง
storacha.network์์ ๊ธฐ๋ณธ ํตํฉ์ ์ํด
w3CLI๋ฅผ ๋ํํฉ๋๋ค.๊ด๋ฒ์ํ
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โ๏ธ ๊ณ ๊ธ ์ ์ฅ์( Blob, CAR, ์ ๋ก๋, ์ธ๋ฑ์ค, ์ก์ธ์ค ํด๋ ์, Filecoin ์ ๋ณด ๊ด๋ฆฌ
๐ณ ๊ณ์ ๋ฐ ์ฒญ๊ตฌ:
w3_plan_get,w3_coupon_create,w3_usage_report
Related MCP server: Deskaid
๐ ๏ธ ํ์ ์กฐ๊ฑด
Node.js: ๋ฒ์ 22.0.0 ์ด์(
node -v).w3์๋ฒ๊ฐ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 ๋ผ์ด์ ์ค์ ๋ฐ๋ผ ๋ผ์ด์ ์ค๊ฐ ๋ถ์ฌ๋ฉ๋๋ค. ์์ธํ ๋ด์ฉ์ ๋ผ์ด์ ์ค ํ์ผ์ ์ฐธ์กฐํ์ธ์.