mcp-ipfs

🪐 MCP IPFS サーバー (storacha.network) 🛰️

スクリーンショット

w3コマンドラインインターフェイス ( @web3-storage/w3cli ) を介してstoracha.networkプラットフォームと対話するためのModel Context Protocol (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がグローバルにインストールされ、設定されていることを確認してください。
npm install -g @web3-storage/w3cli w3 login <your-email@example.com> # Follow email verification steps
環境変数: w3_loginツールでは、 W3_LOGIN_EMAIL環境変数をw3 loginに使用するのと同じ電子メールに設定する必要があります。

🏗️ プロジェクト構造

コードベースは次のように構成されています。

src/
├── index.ts          # Main server entry point, MCP setup, request routing
├── schemas.ts        # Zod schemas defining input arguments for each tool
├── tool_handlers.ts  # Implementation logic for each MCP tool
├── utils.ts          # Helper functions (e.g., running w3 commands, parsing JSON)
└── utils/
    └── logger.ts     # Basic logger configuration

🚀 MCP クライアントでの使用

このサーバーは、MCP互換のクライアントであればどれでも使用できます。このサーバーに接続するには、クライアントを設定する必要があります。

例: NPX (単純なローカル使用に推奨)

これは、 npmと前提条件が満たされていることを前提としています。

{
  "mcpServers": {
    "ipfs": {
      "command": "npx",
      "args": ["-y", "mcp-ipfs"],
      "env": {
        "W3_LOGIN_EMAIL": "your-email@example.com"
      }
    }
  }
}

例: Docker

最初にイメージをビルドするか (ビルドセクションを参照)、事前にビルドされたイメージalexbakers/mcp-ipfsを使用します。

{
  "mcpServers": {
    "mcp-ipfs": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/path/to/your/project:/path/to/your/project",
        "-e",
        "W3_LOGIN_EMAIL",
        "alexbakers/mcp-ipfs"
      ],
      "env": {
        "W3_LOGIN_EMAIL": "your-email@example.com"
      }
    }
  }
}

📝 パスに関する注意:

いくつかの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 ）を使用する必要があります。

📦 ビルド

リポジトリをクローンし、依存関係をインストールします。

git clone https://github.com/alexbakers/mcp-ipfs.git
cd mcp-ipfs
npm install

TypeScript コードをビルドします。

npm run build

その後、サーバーを直接実行できます。

# Ensure W3_LOGIN_EMAIL is set in your environment
export W3_LOGIN_EMAIL="your-email@example.com"
node dist/index.js

または公開します（権利がある場合）。

npm publish

🐳 Dockerビルド

Docker イメージをビルドします。

# Build locally (replace with your username/repo and desired tag)
docker build -t alexbakers/mcp-ipfs .

📜 ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。詳細はLICENSEファイルをご覧ください。

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

View all tools

🪐 MCP IPFS サーバー

このサーバーは、言語モデル 🤖 やその他の MCP クライアントが storacha.network スペースを管理し、データをアップロード/ダウンロードし、委任を管理し、w3 コマンドをシームレスにラップすることでさまざまな他のタスクを実行できるようにします。

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-server-commands
g0t4
A
security
A
license
A
quality
An MCP server to run commands.
Last updated -
2
265
150
TypeScript
MIT License
Weaviate MCP Server
kirill-markin
A
security
A
license
A
quality
A simple MCP server that facilitates website fetching through a configurable server platform using stdio or SSE transport, allowing integration with tools like Cursor for streamlined access.
Last updated -
2
23
Python
MIT License
Deskaid
ezyang
A
security
A
license
A
quality
An MCP server that provides tools for reading, writing, and editing files on the local filesystem.
Last updated -
1
1,241
Python
Apache 2.0
Unstructured API MCP Serverofficial
Unstructured-IO
A
security
F
license
A
quality
An MCP server implementation that enables interaction with the Unstructured API, providing tools to list, create, update, and manage sources, destinations, and workflows.
Last updated -
39
28

View all related MCP servers