将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助手可以:
- 从文件系统读取文件
- 查询数据库
- 调用外部API
- 从URL获取和搜索文档 — 这就是llms.txt发挥作用的地方
为什么llms-full.txt非常适合MCP
您的llms-full.txt文件是一个包含最重要页面完整文本的单一Markdown格式文档。它被设计为机器可读且自包含——这正是MCP服务器回答关于您产品的问题所需要的。
将llms-full.txt连接到MCP服务器,实际上是给AI助手提供了一个关于您产品的精心策划、始终最新的知识库。不需要嵌入流水线,不需要向量数据库,不需要RAG基础设施——只需一个URL和几行配置。
将llms.txt用于SEO与将其用于MCP的主要区别:
| 用例 | 文件 | 使用方式 |
|---|---|---|
| SEO / AI发现 | /llms.txt | AI系统被动爬取 |
| MCP集成 | /llms-full.txt | AI助手按需主动获取 |
两个文件都值得拥有。/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配置文件:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
添加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方法
- 实时更新 — 每次提问时,MCP服务器都会获取您llms-full.txt的最新版本
- 零摩擦发现 — 他们留在编辑器中;无需切换浏览器标签
- 上下文感知的代码生成 — 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分钟。