跳到内容
返回

将llms.txt与MCP结合使用:将您的文档变成AI知识库

发布于:  at  10:00 上午

将llms.txt与MCP结合使用:将您的文档变成AI知识库

核心要点

  • Model Context Protocol(MCP)让Claude等AI助手可以从外部来源(包括您的llms.txt文件)获取实时知识。
  • 将llms-full.txt文件连接到MCP服务器,开发者无需离开编辑器就能获得关于您产品的即时准确答案。
  • 使用npx设置不超过10分钟——无需管理服务器。
  • 任何拥有公开llms-full.txt的网站今天就可以作为MCP知识源连接。

Anthropic于2024年底推出的Model Context Protocol(MCP)已悄然成为开发工具领域最实用的进步之一。根据MCP的GitHub仓库,该协议在头六个月内达到了超过1,000个社区构建的服务器(Anthropic MCP,2025年)。该生态系统中出现的最有用的模式之一:将您的llms-full.txt文件用作AI助手可以实时查询的活跃知识源。

什么是Model Context Protocol(MCP)?

MCP是一个开放协议,让AI助手可以以标准化方式连接到外部工具和数据源。可以把它想成AI集成的USB-C标准——不是每个工具都构建自定义连接器,而是MCP提供了任何兼容AI都可以使用的单一接口。

有了MCP,像Claude(在Claude Desktop或Cursor中)这样的AI助手可以:

为什么llms-full.txt非常适合MCP

您的llms-full.txt文件是一个包含最重要页面完整文本的单一Markdown格式文档。它被设计为机器可读且自包含——这正是MCP服务器回答关于您产品的问题所需要的。

llms-full.txt连接到MCP服务器,实际上是给AI助手提供了一个关于您产品的精心策划、始终最新的知识库。不需要嵌入流水线,不需要向量数据库,不需要RAG基础设施——只需一个URL和几行配置。

将llms.txt用于SEO与将其用于MCP的主要区别:

用例文件使用方式
SEO / AI发现/llms.txtAI系统被动爬取
MCP集成/llms-full.txtAI助手按需主动获取

两个文件都值得拥有。/llms.txt是索引;/llms-full.txt是完整内容。

使用llms-full.txt设置MCP服务器

让我们看一个真实的例子。Taiga UI组件库将其完整文档公开为llms-full.txt,并提供任何开发者都可以连接的MCP服务器:

{
  "mcpServers": {
    "taiga-ui": {
      "command": "npx",
      "args": [
        "@taiga-ui/mcp@latest",
        "--source-url=https://taiga-ui.dev/llms-full.txt"
      ]
    }
  }
}

此配置告诉Claude(或任何兼容MCP的AI)通过npx启动一个本地MCP服务器,该服务器获取并搜索Taiga UI文档。开发者可以问”如何使用TuiInput组件?“并直接从库自己的文档中获得准确的、有来源的答案。

只需更换URL,就可以以同样的方式连接到/next版本的文档:

{
  "mcpServers": {
    "taiga-ui-next": {
      "command": "npx",
      "args": [
        "@taiga-ui/mcp@latest",
        "--source-url=https://taiga-ui.dev/next/llms-full.txt"
      ]
    }
  }
}

如何将此配置添加到您的AI工具

Claude Desktop

打开您的Claude Desktop配置文件:

添加mcpServers块。如果文件已经有其他服务器,只需将您的新条目添加到现有对象中:

{
  "mcpServers": {
    "my-product-docs": {
      "command": "npx",
      "args": [
        "@taiga-ui/mcp@latest",
        "--source-url=https://yourdomain.com/llms-full.txt"
      ]
    }
  }
}

重启Claude Desktop。您会看到聊天输入中出现一个工具图标——这确认MCP已连接。

Cursor

在Cursor中,转到Settings > MCP并添加服务器配置。Cursor支持与Claude Desktop相同的MCP JSON格式。

VS Code(使用Copilot或Claude扩展)

将配置添加到工作区的.vscode/mcp.json文件中:

{
  "servers": {
    "my-product-docs": {
      "command": "npx",
      "args": [
        "@taiga-ui/mcp@latest",
        "--source-url=https://yourdomain.com/llms-full.txt"
      ]
    }
  }
}

为llms-full.txt构建您自己的MCP服务器

不想依赖第三方MCP包?您可以构建一个最小化的。模式很简单:获取llms-full.txtURL,按Markdown标题将其分割成节,并公开一个按关键字过滤节的搜索工具。

使用官方MCP TypeScript SDK的最小结构:

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";

const server = new McpServer({ name: "my-docs", version: "1.0.0" });

server.tool(
  "search_docs",
  { query: z.string() },
  async ({ query }) => {
    const res = await fetch("https://yourdomain.com/llms-full.txt");
    const text = await res.text();
    const sections = text.split(/^##+ /m);
    const matches = sections.filter(s =>
      s.toLowerCase().includes(query.toLowerCase())
    );
    return { content: [{ type: "text", text: matches.join("\n\n---\n\n") }] };
  }
);

const transport = new StdioServerTransport();
await server.connect(transport);

这是一个可以投入生产的起点。实际实现会添加缓存(文件很少更改)、大文件的分页和模糊匹配。

这为您的用户带来什么

当您的文档通过MCP连接时,使用AI编码助手的开发者获得:

从我们测试这种模式在多个库上的经验来看,最大的收益是消除”幻觉”API答案。当AI基于您实际的llms-full.txt时,它就不再发明不存在的方法签名了。

这种模式需要llms-full.txt吗?

是的。MCP模式需要一个包含文档完整内容的文件——而不仅仅是索引。如果您只有/llms.txt,您会得到导航,但没有足够的细节让AI回答具体问题。

要自动为您的网站生成llms-full.txt,请使用LLMGenerator. 它爬取您的网站,一步生成两个文件。

常见问题

我的llms-full.txt需要可公开访问吗? 是的,如果您使用基于URL的MCP服务器。对于私有文档,您可以在MCP参数中传递本地文件路径而不是URL。

llms-full.txt可以有多大? 实际限制取决于AI的上下文窗口。200KB以下的文件在大多数模型上可靠地工作。对于更大的文档集,考虑按节分割并运行多个MCP服务器。

我可以在任何兼容MCP的AI上使用这种模式吗? 是的。MCP协议是开放的,与模型无关。任何支持MCP的AI工具(Claude、Cursor、Zed以及越来越多的其他工具)都可以使用相同的配置。

文档更改时我需要重新发布llms-full.txt吗? 理想情况下是的。大多数MCP服务器在每次请求时都会获取URL,所以您的文档只需要在一个稳定的URL上。如果您在部署时自动化重新生成,您的MCP集成就会自动保持最新。


llms-full.txt和MCP的结合是2026年让您的文档对开发者真正有用的最实用方式之一。它维护成本低,您这边不需要AI基础设施,为任何使用AI编码助手的人提供了真实价值。

首先使用LLMGenerator生成您的llms-full.txt,然后将MCP配置添加到您的Claude Desktop或Cursor。整个过程不超过15分钟。



下一篇
如何将llms.txt添加到您的网站(分步指南)