Docs To Llm

用于文档处理的 MCP 服务

用于将技术文档处理为 llm.txt 格式的 MCP 服务，可在 Cursor、Windsurf、Cline 或 Roo Code 等环境中用作大模型的上下文。

要求

• Python 3.7+
• uv（推荐）或 pip

下载仓库

使用 MCP 服务前，需要从 GitHub 克隆仓库：

git clone https://github.com/Rybens92/docs-to-llm.txt_generator /your/chosen/directory

然后更新 mcp_settings.json 配置中的路径：

"args": [
  "/your/path/to/this/mcp/server/src/server.py"
]

将 /your/path/to/this/mcp/server 替换为克隆仓库的实际路径。

安装

使用 uv（推荐）：

uv pip install -r requirements.txt

或使用 pip：

pip install -r requirements.txt

=======

运行

开发模式（推荐用于测试）

fastmcp dev src/server.py

在 Claude Desktop 中安装

fastmcp install src/server.py

直接执行

python src/server.py

在 Roo Code 或 Cline 中使用

mcp_settings.json 配置

将以下配置添加到 Roo Code 或 Cline 中的 mcp_settings.json：

{
  "mcpServers": {
    "docs-to-llm": {
      "command": "python",
      "args": [
        "/your/path/to/this/mcp/server/src/server.py"
      ],
      "disabled": false
    }
  }
}

请记得将 "/your/path/to/this/mcp/server" 替换为项目目录的实际路径。

使用示例

配置完成后，可以这样使用该服务：

<use_mcp_tool>
<server_name>docs-to-llm</server_name>
<tool_name>process_documentation</tool_name>
<arguments>
{
  "url": "https://example.com/docs",
  "library_name": "example_lib",
  "txt_save_path": "/path/to/save/directory"
}
</arguments>
</use_mcp_tool>

该服务将生成两个文件：

• llm_{library_name}_short.txt - 仅包含文档标题和链接
• llm_{library_name}_full.txt - 包含完整的文档内容

可用工具

process_documentation

处理指定 URL 中的文档。

参数：

• url（字符串）- 文档页面的 URL
• library_name（字符串）- 库的名称（用于输出文件名）
• txt_save_path（字符串）- 输出文件的保存路径

返回值：

• success（布尔值）- 操作状态
• message（字符串）- 结果信息
• files（对象）- 生成文件的路径，键为 "short" 和 "full"

功能

• 自动检测文档导航部分
• 将相对 URL 转换为绝对 URL
• 移除不必要的 HTML 元素（脚本、样式、菜单）
• 处理过程中报告进度
• 详细记录错误
• 使用智能评分系统查找相关文档链接
• 自动检测失败时启用回退机制
• 根据库名称生成经过清理的文件名