AI导哈

模型上下文协议服务器

一个结合网页转Markdown和文档搜索功能的模型上下文协议服务器，适用于高效获取网页内容和嵌入式文档。

  • by HaiderManzoor
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 HaiderManzoor/markdown_mcp

使用说明

markdown_mcp

A. 模型上下文协议 （MCP）服务器，它结合了：

  • Web → 标记语言 --令牌高效获取(web_outline, web_section, web_content, web_search)
  • TechFlow文档 --搜索和浏览嵌入式文档(search_docs, get_doc, list_categories)

一切都从一个 单条目文件: index.js.

安装

git clone <repo-url>
cd markdown_mcp
npm install
npx playwright install chromium

用法

将您的MCP客户端指向 index.js （使用a 绝对路径 在您的机器上）。

克劳德代码

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "markdown_mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/markdown_mcp/index.js"]
    }
  }
}

光标

添加 .cursor/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "markdown_mcp": {
      "command": "node",
      "args": ["/path/to/markdown_mcp/index.js"]
    }
  }
}

帆板运动

添加 ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "markdown_mcp": {
      "command": "node",
      "args": ["/path/to/markdown_mcp/index.js"]
    }
  }
}

克劳德桌面

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "markdown_mcp": {
      "command": "node",
      "args": ["/path/to/markdown_mcp/index.js"]
    }
  }
}

这 web2md npm二进制文件（如果从这个包链接）也会运行 index.js.

可用工具

Web抓取

工具 说明
web_outline 获取带有标题树和标记计数的页面结构。 先用这个。 （约200个代币）
web_section 按标题名称获取特定节。支持部分匹配。
web_content 使用可配置的令牌上限以markdown的形式获取完整页面。
web_search 在页面中搜索术语。返回带有上下文摘录的匹配部分。

文档

工具 说明
search_docs 对嵌入式TechFlow文档进行全文搜索。
get_doc 按ID加载文档（例如。 DOC-001).
list_categories 列出文档类别和计数。

推荐工作流程（网络）

# Step 1: Get the outline (cheap, ~200 tokens)
web_outline url="https://docs.example.com/api"

# Step 2: Fetch only the sections you need
web_section url="https://docs.example.com/api" headings="Authentication"

# Step 3: Or search for a specific term
web_search url="https://docs.example.com/api" query="rate limit"

与获取完整页面相比，这种分层方法节省了大量令牌。

特性

  • JavaScript密集型网站（SPA）的剧作家渲染
  • 如果Playwright失败，则自动回退到简单获取
  • 24小时本地磁盘缓存(~/.cache/web2md/)
  • 外部网络内容用安全标签包裹，以降低即时注入风险
  • web工具输出的令牌估计

需求

  • Node.js 18+
  • 剧作家Chromium(npx playwright install chromium)

关于维护人员

该项目由以下人员维护 海德尔·曼祖尔。您可以在上浏览其他公共存储库和活动 他们的GitHub个人资料.

许可证

麻省理工学院

相关 MCP