Pinata MCP

未处理的标签

一种模型上下文协议（MCP）服务器，为Claude提供对Pinata的访问。这种集成允许Claude通过Pinata的API与公共和私有IPFS进行交互。

设置

先决条件

• 已安装Node.js 18+
• 具有API密钥（JWT）的Pinata帐户
• Pinata网关URL

安装

安装将取决于您使用的是Claude Code还是Claude Desktop。

克劳德代码

跑 claude mcp add 并按照提示提供以下信息：

Server Name: pinata
Server Scope: Project or Global
Server Command: npx
Command Arguments: pinata-mcp /path/to/allowed/directory
Environment Variables: PINATA_JWT=,GATEWAY_URL=example.mypinata.cloud

克劳德桌面版

将以下配置添加到 claude_desktop_config.json:

{
  "mcpServers": {
    "pinata": {
      "command": "npx",
      "args": [
        "pinata-mcp",
        "/path/to/allowed/directory",
        "/another/allowed/directory"
      ],
      "env": {
        "PINATA_JWT": "",
        "GATEWAY_URL": "example.mypinata.cloud"
      }
    }
  }
}

注： 目录参数是可选的。如果没有提供，服务器将只允许访问当前工作目录。您可以指定多个目录以允许从多个位置访问文件。

可用工具

认证

文件操作

内容访问

集团运营

x402付款说明

使用x402协议实现内容货币化的工具：

CID签名

使用EIP-712签名进行加密内容验证的工具：

已签名的上传URL

CID引脚

矢量化（AI/语义搜索）

公用事业

本地开发

在开发过程中本地测试MCP服务器：

1.克隆并安装依赖项

git clone https://github.com/PinataCloud/pinata-mcp.git
cd pinata-mcp
npm install

2.建设项目

npm run build

3.设置环境变量

创建一个 .env 项目根目录中的文件（可选，您也可以在MCP配置中传递这些文件）：

PINATA_JWT=your_pinata_jwt_here
GATEWAY_URL=your-gateway.mypinata.cloud

4.配置Claude以使用本地构建

克劳德代码

跑 claude mcp add 使用本地路径：

Server Name: pinata-dev
Server Scope: Project
Server Command: node
Command Arguments: /path/to/pinata-mcp/dist/index.js /path/to/allowed/directory
Environment Variables: PINATA_JWT=,GATEWAY_URL=example.mypinata.cloud

克劳德桌面版

更新 claude_desktop_config.json 指向您的本地版本：

{
  "mcpServers": {
    "pinata-dev": {
      "command": "node",
      "args": [
        "/path/to/pinata-mcp/dist/index.js",
        "/path/to/allowed/directory"
      ],
      "env": {
        "PINATA_JWT": "",
        "GATEWAY_URL": "example.mypinata.cloud"
      }
    }
  }
}

5.测试变更

更改代码后：

1. 重建： npm run build
2. 重新启动Claude Code或Claude Desktop以获取更改

MCP检验员测试

使用 MCP检查员 要测试服务器，请执行以下操作：

Web UI（交互式调试）

npx @modelcontextprotocol/inspector \
  -e PINATA_JWT=your_jwt \
  -e GATEWAY_URL=your-gateway.mypinata.cloud \
  -- node dist/index.js

这将打开一个浏览器UI，您可以在其中交互式地列出工具，使用参数调用它们，并检查响应。

CLI模式（用于脚本/CI）

# List all available tools
npx @modelcontextprotocol/inspector --cli --method tools/list \
  -e PINATA_JWT=your_jwt \
  -e GATEWAY_URL=your-gateway.mypinata.cloud \
  -- node dist/index.js

# Call a specific tool
npx @modelcontextprotocol/inspector --cli --method tools/call \
  --tool-name testAuthentication \
  -e PINATA_JWT=your_jwt \
  -e GATEWAY_URL=your-gateway.mypinata.cloud \
  -- node dist/index.js

克劳德提示示例

Test my Pinata connection:
"Test my Pinata authentication to make sure everything is working"

Upload an image to Pinata:
"Upload this image to my Pinata account as a private file named 'My Example Image'"

Search for files:
"Search my Pinata account for all PNG files"

Create a group and add files:
"Create a new group called 'Project Assets' on Pinata, then find all my JSON files and add them to this group"

Fetch content from IPFS:
"Fetch the content with CID QmX... from IPFS"

Create a payment instruction for content monetization:
"Create a payment instruction called 'Premium Content' that requires 0.01 USDC on Base to access"

Pin an existing CID:
"Pin the CID bafkreih5aznjvttude6c3wbvqeebb6rlx5wkbzyppv7garjiubll2ceym4 to my account"

Vectorize files for AI search:
"Vectorize the file with ID abc123 so I can search it semantically"

Query vectorized content:
"Search my vectorized files in group xyz for 'machine learning concepts'"