🚀 项目说明：pinata - mcp
这是一个为Claude访问Pinata而提供的模型上下文协议（MCP）服务器。该集成让Claude能够借助Pinata的API与公共和私有IPFS进行交互，为用户在IPFS文件管理方面提供了便利。
🚀 快速开始
启动Claude Code或打开Claude Desktop后，就能开始使用pinata - mcp进行各类IPFS文件操作啦。
📦 安装指南
先决条件
- 已安装Node.js 18+版本
- 拥有一个Pinata账户及相应的API密钥（JWT）
安装步骤
根据您使用的是Claude Code还是Claude Desktop，安装方式有所不同。
Claude Code
运行claude mcp add并按照提示输入以下信息：
服务器名称: pinata
服务器范围: 项目或全局
服务器命令: npx
命令参数: pinata-mcp /指定的文件夹路径 /另一个指定的文件夹路径
环境变量: PINATA_JWT=<您的JWT密钥>, GATEWAY_URL=example.mypinata.cloud
Claude Desktop
将以下配置添加到claude_desktop_config.json文件中：
{
"mcpServers": {
"pinata": {
"command": "npx",
"args": [
"pinata-mcp",
"/指定的文件夹路径"
],
"env": {
"PINATA_JWT": "<您的JWT密钥>",
"GATEWAY_URL": "example.mypinata.cloud"
}
}
}
}
💻 使用示例
基础用法
启动Claude Code或打开Claude Desktop后，即可开展以下操作：
文件操作
- 上传文件：可将文件上传到Pinata（公共或私有IPFS）
- 搜索文件：能根据名称、CID或MIME类型搜索文件
- 获取文件详情：可通过ID查询文件详情
- 更新文件元数据：可以更新文件的名称和键值对等元数据
- 删除文件：能从Pinata中移除文件
组操作
- 列出组别：可选择过滤条件列出组别
- 创建新的组别：用于组织文件
- 获取组信息：可通过ID查询组信息
- 更新组资料
- 删除组别
- 添加/移除文件：可将文件添加或移除到指定组别中
内容访问
- 生成私有下载链接：可生成私有下载链接以访问私人文件
- 从IPFS网关获取内容：可选择将内容保存到本地
高级用法
以下是指导Claude使用pinata - mcp的一些示例：
上传图片至Pinata:
“请将~/Pictures/example.jpg文件上传到我的Pinata账户，作为私有文件命名为'我的示例图片'”
搜索文件:
“在我的Pinata账户中查找所有PNG格式的文件”
创建组别并添加文件:
“在Pinata上新建一个名为'项目资产'的组别，然后找到所有的JSON文件并将它们加入该组别”
从IPFS获取内容:
“提取CID为QmX...的IPFS内容，并将其保存到我的下载文件夹中”
📄 联系我们
如遇任何问题，请发送邮件至此处与我们联系！