pure.md MCP server

基本能力

产品定位

puremd-mcp 是一个为 MCP 客户端提供 web 内容解锁和搜索功能的工具，旨在通过 pure.md 的服务将网页内容转换为纯 Markdown 格式。

核心功能

1. web 内容解锁：通过 unblock-url 工具从网页中提取 Markdown 内容，避免被机器人检测拦截。
2. web 搜索：通过 search-web 工具搜索 web 并将结果拼接为 Markdown 格式。
3. 全局缓存：缓存响应以减轻源服务器的压力。

适用场景

1. 开发工具集成：为 Cursor、Windsurf 和 Claude Desktop 等 MCP 客户端提供 web 内容访问能力。
2. 自动化脚本：在脚本、API 或应用中可靠地获取 web 内容。
3. 内容生成：将 HTML、PDF、图片等转换为纯 Markdown 格式。

工具列表

1. unblock-url：从网页中提取 Markdown 内容，避免被机器人检测拦截。
2. search-web：搜索 web 并将结果拼接为 Markdown 格式。

常见问题解答

1. 是否需要 API 密钥？
2. 生成 API 密钥是可选的，但可以解锁更高的速率限制。如果匿名使用，可以将 PUREMD_API_KEY 设置为空字符串。
3. 如何获取 API 密钥？
4. 在 pure.md 上注册新账户并生成 API 令牌。

使用教程

使用依赖

无特殊依赖，直接通过 npm 安装即可。

安装教程

1. 通过 npm 安装： bash npx -y puremd-mcp
2. 通过 Smithery 安装（适用于 Claude Desktop）： bash npx -y @smithery/cli install @puremd/puremd-mcp --client claude

调试方式

1. 配置 MCP 客户端：
2. 对于 Cursor，编辑 ~/.cursor/mcp.json 文件。
3. 对于 Windsurf，编辑 ./codeium/windsurf/model_config.json 文件。
4. 对于 Claude Desktop，编辑 ~/Library/Application Support/Claude/claude_desktop_config.json 文件。
5. 设置环境变量：
6. 确保 PUREMD_API_KEY 设置为有效的 API 令牌或空字符串。
7. 运行工具：
8. 使用 unblock-url 或 search-web 工具测试功能。

许可证

None