🚀 使用 Pinata 的模型上下文协议（MCP）服务器
本项目借助 Pinata 的模型上下文协议（MCP）服务器，让 Claude 具备访问公共和私有 IPFS 的能力。通过此集成，Claude 能够借助 Pinata 的 API 与公共和私有 IPFS 进行交互。
🚀 快速开始
使用本项目，可让 Claude 实现对公共和私有 IPFS 的访问。在完成安装配置后，即可启动 Claude 开始使用相关功能。
📦 安装指南
先决条件
- 已安装 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 删除文件：可删除 Pinata 中的文件。
组操作
- 列出组别：可列出组别，且带有可选筛选功能。
- 创建新的组别：用于组织文件。
- 获取组别详情：通过 ID 获取组别详情。
- 更新组信息：可更新组的相关信息。
- 删除组别：可删除指定组别。
- 添加/移除文件：可将文件添加到组别中或从组别中移除。
内容访问
- 生成私人下载链接：用于访问私有文件。
- 从 IPFS 门路获取内容：并可选本地保存。
高级用法
以下是指导 Claude 使用 pinata - mcp 的一些示例：
上传图片到 Pinata:
"请将 ~/Pictures/example.jpg 文件上传到我的 Pinata 账户，作为私有文件命名为 'My Example Image'"
搜索文件:
"在 Pinata 中搜索所有 PNG 格式的文件"
创建组别并添加文件:
"在 Pinata 上创建一个新的名为 'Project Assets' 的组别，然后找到所有 JSON 文件并将它们添加到该组中"
从 IPFS 下载内容:
"获取 CID 为 QmX... 的 IPFS 内容，并将其保存到我的下载文件夹"
📚 常见问题
如遇任何问题，请发送邮件至 此处 联系我们！