跳转到主要内容

​
概览

Web2MD MCP server 基于 Model Context Protocol (MCP)——一个连接 AI 模型与外部工具、数据源的开放标准——把 Web2MD 封装成一组 AI 助手可以直接调用的工具。 配置好之后，你可以让 Claude、Cursor 或 Windsurf 在对话中直接转换页面、搜索你的转换历史，或取回已保存的 Markdown。
MCP server 需要 Web2MD API key（PRO 套餐）。在控制台生成。

​
可用工具

MCP server 提供三个工具：

​
convert_url

抓取一个 URL 并把页面内容以 Markdown 返回。支持与 REST API 相同的转换选项。 示例提示： “Convert this URL to markdown: https://docs.example.com/getting-started” 用自然语言查询搜索你之前保存的所有转换记录，返回匹配的转换列表，包含标题、URL 和相关性得分。 示例提示： “Search my saved pages for articles about database indexing”

​
get_conversion

按 ID 取回某条已保存转换的完整 Markdown 内容。适合先用 semantic_search 找到目标，再把完整文档拉进上下文。 示例提示： “Get the full content of conversion abc123”

​
配置

打开 Claude Desktop 配置文件：
  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows： %APPDATA%\Claude\claude_desktop_config.json
在 mcpServers 下添加 web2md 条目：
重启 Claude Desktop，工具选择器里应该会出现 Web2MD 的工具。

​
使用示例

MCP server 跑起来后，在 AI 助手里用自然语言即可：
你： Convert this URL to markdown: https://react.dev/learn/thinking-in-react助手： （调用 convert_url） 这是 “Thinking in React” 转换后的 Markdown……
你： Search my saved pages for anything about authentication助手： （调用 semantic_search） 我找到 3 条与 authentication 相关的已保存转换：
  1. “OAuth 2.0 Guide” —— 2 天前保存
  2. “JWT Best Practices” —— 上周保存
  3. …
你： Get the full content of conversion abc123助手： （调用 get_conversion） 这是完整的 Markdown 内容……
可以在一次对话中组合使用多个工具。例如：“Search my conversions for React docs, then get the full content of the most recent one.”

​
故障排查

确认你在编辑配置文件后重启了应用。同时在终端里验证 npx web2md-mcp 能正常运行。
确认 WEB2MD_API_KEY 填写正确，并且你的 PRO 订阅处于有效状态。可以在 API keys 页面核对你的 key。
先尝试全局安装：npm install -g web2md-mcp，然后把 command 改成 web2md-mcp 并删掉 args 字段。