pure.md MCP Server 使用说明

项目简介

pure.md MCP 服务器是一个基于 Model Context Protocol (MCP) 的应用后端，旨在帮助 LLM 客户端（如 Cursor, Windsurf, Claude Desktop）克服网页访问限制，并以结构化的 Markdown 格式获取网页内容和搜索结果。它通过集成 pure.md 的服务，为 LLM 提供强大的网页内容处理能力。

主要功能点

网页内容抓取 (unblock-url): 绕过网页反爬虫机制，抓取指定 URL 的网页内容，并转换为 Markdown 格式返回。
网页搜索 (search-web): 执行网页搜索查询，并将搜索结果整合为 Markdown 格式返回。
MCP 协议支持: 遵循 MCP 协议标准，易于集成到支持 MCP 协议的 LLM 客户端。
API 密钥认证 (可选): 支持 API 密钥认证，用于提升请求频率限制（可选，匿名使用需设置 API 密钥为空字符串）。

安装步骤

由于 puremd-mcp 通常作为 MCP 客户端的插件运行，因此通常无需手动安装。客户端（如 Cursor, Windsurf, Claude Desktop）会根据配置自动下载和运行 puremd-mcp。

如果您需要手动安装和测试，请确保您已安装 Node.js 和 npm，然后执行以下命令：

npm install puremd-mcp

服务器配置

您无需手动配置 puremd-mcp 服务器本身。配置主要在 MCP 客户端中进行，用于告知客户端如何启动和连接 puremd-mcp 服务器。

以下是在不同 MCP 客户端中配置 puremd-mcp 服务器的示例 (JSON 格式)。您需要将这些配置添加到对应客户端的配置文件中。请注意，您无需修改以下 JSON 代码，只需复制粘贴到客户端的配置文件中，并根据需要替换 '<TOKEN>' 为您的 pure.md API 密钥。

Cursor 配置 ( '~/.cursor/mcp.json' )

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"  // 您的 pure.md API 密钥 (可选，留空字符串 "" 为匿名访问)
      }
    }
  }
}

Windsurf 配置 ( './codeium/windsurf/model_config.json' )

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"  // 您的 pure.md API 密钥 (可选，留空字符串 "" 为匿名访问)
      }
    }
  }
}

Claude Desktop 配置 ( '~/Library/Application\ Support/Claude/claude_desktop_config.json' )

{
  "mcpServers": {
    "pure.md": {
      "command": "npx",
      "args": ["-y", "puremd-mcp"],
      "env": {
        "PUREMD_API_KEY": "<TOKEN>"  // 您的 pure.md API 密钥 (可选，留空字符串 "" 为匿名访问)
      }
    }
  }
}

基本使用方法

puremd-mcp 服务器在后台运行，无需用户直接操作。配置完成后，当您的 MCP 客户端（如 Cursor, Windsurf, Claude Desktop）需要访问网页内容或进行网页搜索时，它将自动调用 puremd-mcp 服务器提供的工具，并将结果返回给您。

具体使用方式取决于您的 MCP 客户端的功能和界面。通常，您可以通过自然语言指令或客户端提供的特定功能入口来触发网页内容抓取和搜索操作。

例如，在 Cursor 中，您可能可以直接提问 "请总结一下这个网页的内容 [URL]"，Cursor 可能会自动调用 puremd-mcp 的 'unblock-url' 工具来完成任务。

请参考您的 MCP 客户端的文档，了解如何利用配置的 MCP 服务器提供的功能。

关键词