MCP Server

MCP サーバー

1. MCP（Model Context Protocol）とは？

Model Context Protocol（MCP）は、モデル、エージェント、コンテキストデータ間のやり取りのための標準です。コミュニティによって開発・保守されています。詳細については、公式リポジトリをご覧ください：MCP GitHub。

2. IPFS とは？

InterPlanetary File System（IPFS）は、分散型のデータ保存と共有を可能にする分散ファイルシステムです。MCP では、信頼性と耐障害性を確保するために、データの保存や操作に使用されます。

3. MCP サーバーのアーキテクチャ概要

コンポーネント：

• MCP ノード — MCP リクエストを処理する中核的なサーバーコンポーネントです。
• IPFS — コンテンツを扱う分散型ストレージシステムです。
• クライアント — MCP サーバーとやり取りして、データを送受信します。
• Claude AI — MCP のやり取りの処理と強化に使用されます。

コンポーネント間のやり取り：

1. クライアントが MCP ノードにリクエストを送信します。
2. MCP ノードがリクエストを処理し、必要に応じて IPFS とやり取りします。
3. Claude AI がレスポンスの処理と最適化を支援します。
4. レスポンスがクライアントに返されます。

4. MCP サーバーのデプロイ

要件：

• Node.js（推奨バージョン 18 以降）
• NPM または Yarn

インストール

インストール方法は、Claude Code または Claude Desktop のどちらを使用するかによって異なります。

Claude Code

claude mcp add を実行し、以下の情報を入力するよう求められたら従ってください。

Server Name: mcp-ipfs
Server Command: node
Command Arguments: node /ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ipfs-server/build/index.js

Claude Desktop

以下の設定を claude_desktop_config.json に追加してください。

  {
  "mcpServers": {
    "ipfs-mcp": {
      "command": "node",
      "args": [
        "/Absolute/path/to/mcp-ipfs-server/build/index.js"
      ]
    }
  }
}

自動インストールとデプロイ

以下の bash スクリプトを使用して、サーバーのデプロイを自動化できます。

#!/bin/bash

sudo apt update
sudo apt install -y wget tar git npm

wget https://github.com/ipfs/kubo/releases/download/v0.34.1/kubo_v0.34.1_linux-amd64.tar.gz

tar -xvzf kubo_v0.34.1_linux-amd64.tar.gz

cd kubo
sudo bash install.sh

ipfs init

sudo apt install ufw
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 4001/tcp
sudo ufw allow 8080/tcp
sudo ufw allow 22/tcp
sudo ufw allow 5001/tcp
sudo ufw enable
sudo ufw status




# Clone the MCP server repository
git clone https://github.com/AleksanStark/mcp-ipfs-server.git
cd mcp-ipfs-server

# Install dependencies
npm install
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript
# Build the project
npm run build
ipfs daemon

使用方法

MCP を使い始めるには、claude コマンドで Claude Code を起動するか、Claude Desktop を起動してください。利用可能な操作は以下のとおりです。

ファイル操作

• IPFS への upload-file
• CID による get-file
• CID による pin-file
• CID によるディレクトリ一覧の取得 list-folder
• CID による unpin-file-

Claude 向けプロンプトの例

Claude に ipfs-mcp を使うよう指示する例を以下に示します。

Upload an image to IPFS:
"Please upload the file at ~/Pictures/example.jpg to my Pinata account as a private file named 'My Example Image'"

Get a file from IPFS:
"Get the file from IPFS using the CID""

Pin a file to IPFS:
"Pin the file by it's CID"

Unpin a file to IPFS:
"Unpin the file based on the CID"

質問

問題が発生した場合は、メールでお問い合わせください！