PulpMiner

PulpMiner MCP 服务

来源：github.com/pulpminercom/pulpminer-mcp · 问题：github.com/pulpminercom/pulpminer-mcp/issues

一个适用于 PulpMiner 的 MCP 服务。它让 AI 助手（Cursor、Claude Desktop 及其他任何 MCP 客户端）能够：

• 使用 AI 将任意网页内容生成为 JSON。 PulpMiner 会抓取网页，再由大模型将其转换为结构化 JSON；你也可以指定准确的数据结构。
• 将网页转 JSON 的设置保存为可复用的 REST API（静态 API，或 URL 中带有 {{ variables }} 的动态 API）。
• 从已保存的 API 获取数据并列出这些 API。

工具

工具	功能	后端端点	积分
pulpminer_generate_json	抓取 URL 并使用 AI 将内容转换为 JSON（可选 jsonFormat 示例、CSS selector、额外指令）	POST /external/ai/json	0.25（+0.1 renderJs）
pulpminer_save_as_api	将 URL + JSON 格式（+ 可选动态 URL 模板、缓存）保存为 API；返回 API ID 和端点	POST /external/ai/json/save	免费
pulpminer_fetch_api_data	调用已保存的 API（GET，或通过 variables 调用动态 API 的 POST）	GET/POST /external/{apiId}	0.4（+0.1 renderJs）
pulpminer_list_saved_apis	列出已保存的 API（ID、URL、动态 URL 模板及其变量）	GET /external/api/url	免费
pulpminer_check_api_key	验证 API 密钥并显示已配置的凭据	GET /external/n8n/auth	免费

选项值与后端一致：scraper 为 scraper_1（默认）或 scraper_2。llm 为 llm_2（OpenAI GPT，默认）、llm_1（Google Gemini）或 llm_3（Groq，仅在你的账户启用时可用）。

配置

环境变量	必填	说明
PULPMINER_API_KEY	是	从 PulpMiner 控制面板 → API 密钥获取的 API 密钥。作为 apikey 请求头发送。所有工具只需要此凭据。
PULPMINER_BASE_URL	否	默认值为 https://api.pulpminer.com
PULPMINER_TIMEOUT_MS	否	默认值为 300000（抓取和大模型处理步骤可能需要一些时间）

安装与构建

git clone https://github.com/pulpminercom/pulpminer-mcp.git
cd pulpminer-mcp
npm install
npm run build

运行：

PULPMINER_API_KEY=... node dist/index.js          # stdio
PULPMINER_API_KEY=... node dist/index.js --http   # Streamable HTTP on http://127.0.0.1:3333/mcp

发布到 npm 后，可通过 npx -y pulpminer-mcp 运行。

客户端配置

Cursor（~/.cursor/mcp.json 或 .cursor/mcp.json）

{
  "mcpServers": {
    "pulpminer": {
      "command": "npx",
      "args": ["-y", "pulpminer-mcp"],
      "env": { "PULPMINER_API_KEY": "your-api-key" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "pulpminer": {
      "command": "npx",
      "args": ["-y", "pulpminer-mcp"],
      "env": { "PULPMINER_API_KEY": "your-api-key" }
    }
  }
}

发布之前，请使用本地构建："command": "node", "args": ["/absolute/path/to/pulpminer-mcp/dist/index.js"]。

Streamable HTTP 客户端

使用 --http 启动（使用 PORT、HOST 环境变量；默认绑定到 127.0.0.1:3333），并将客户端指向 http://127.0.0.1:3333/mcp。此服务是无状态的。每个请求都可以在 x-pulpminer-api-key 请求头中发送自己的 API 密钥，该密钥会覆盖 PULPMINER_API_KEY。因此，它可用作托管的多用户端点（请将其置于 HTTPS 后）。

{
  "mcpServers": {
    "pulpminer": {
      "url": "http://127.0.0.1:3333/mcp",
      "headers": { "x-pulpminer-api-key": "your-api-key" }
    }
  }
}

典型流程

1. pulpminer_generate_json { url, jsonFormat? }：预览 JSON。
2. pulpminer_save_as_api { url, jsonFormat, cache?, dynamicUrl? } 返回 apiId 和 endpoint。
3. pulpminer_fetch_api_data { apiId, variables? }

动态 API 示例：dynamicUrl: "https://example.com/search?q={{ query }}"，然后使用 variables: { "query": "laptops" } 获取数据。

开发

npm test        # builds, then runs scripts/smoke-test.mjs against a local mock API (no real calls)
npm run inspect # opens the MCP Inspector UI
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

托管服务（远程）

remote/ 是一个 Cloudflare Worker，通过 Streamable HTTP（无状态）在 https://mcp.pulpminer.com/mcp 提供相同的工具。将你的 PulpMiner API 密钥作为 Authorization: Bearer <key>（或 x-pulpminer-api-key）发送；密钥只会转发到 PulpMiner API，不会被存储。

{ "mcpServers": { "pulpminer": { "url": "https://mcp.pulpminer.com/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } }

本地开发：cd remote && npm install && npm run dev（Node 22+）。