MCP 服务器

1. 什么是 MCP (模型上下文协议)？

模型上下文协议 (MCP) 是模型、代理和上下文数据之间交互的标准。它由社区开发和维护。更多详细信息可以在官方仓库中找到：MCP GitHub。

2. 什么是 IPFS？

星际文件系统 (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 并按照提示输入以下信息：

服务器名称: mcp-ipfs
服务器命令: node
命令参数: 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




# 克隆 MCP 服务器仓库
git clone https://github.com/AleksanStark/mcp-ipfs-server.git
cd mcp-ipfs-server

# 安装依赖
npm install
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript
# 构建项目
npm run build
ipfs daemon

用法

要开始使用 MCP，请使用命令 claude 启动 Claude Code 或启动 Claude Desktop。 以下是可用的操作：

文件操作

• upload-file 上传到 IPFS
• get-file 通过 CID 获取
• pin-file 通过 CID 固定
• list-folder 通过 CID 获取目录列表
• unpin-file- 通过 CID 取消固定

Claude 的示例提示

以下是一些指示 Claude 使用 ipfs-mcp 的示例：

将图像上传到 IPFS：
"请将 ~/Pictures/example.jpg 的文件作为名为 'My Example Image' 的私有文件上传到我的 Pinata 帐户"

从 IPFS 获取文件：
"使用 CID 从 IPFS 获取文件"

将文件固定到 IPFS：
"通过 CID 固定文件"

从 IPFS 取消固定文件：
"基于 CID 取消固定文件"

问题

如果您遇到任何问题，请发送 电子邮件 给我们！