🚀 Docs MCP Server
Docs MCP Server 是一个基于 TypeScript 的模型上下文协议（MCP）服务器，用于提供来自 https://docs.tambo.co/ 的 Tambo 文档服务。
🚀 快速开始
在使用该服务器之前，你需要先进行安装和构建。之后，根据不同的使用场景（开发、生产、测试）选择合适的命令来运行。
✨ 主要特性
- 动态文档发现：自动爬取并发现所有可用的文档页面。
- 智能内容解析：从 Fumadocs 驱动的网站中提取简洁的内容。
- 快速搜索：可在所有发现的文档中进行搜索。
- TypeScript 支持：具备完整的类型安全和现代开发体验。
- 缓存机制：拥有 10 分钟的缓存，以提高性能。
📦 安装指南
基础安装
npm install
在不同工具中的安装配置
在 Cursor 中
在项目根目录下创建或更新 .cursor/mcp.json 文件：
- MacOS/Linux：
{
"mcpServers": {
"tambo-docs": {
"command": "node",
"args": ["D:/oss/docs-mcp-server/dist/index.js"]
}
}
}
- Windows：
{
"mcpServers": {
"tambo-docs": {
"command": "cmd",
"args": ["/c", "node", "D:\\oss\\docs-mcp-server\\dist\\index.js"]
}
}
}
⚠️ 重要提示：MCP 服务器默认不会启用。你需要前往 Cursor 设置 → MCP 设置，然后点击 Tambo Docs MCP 服务器的“启用”按钮。
在 Claude Desktop 中
更新 Claude Desktop 配置文件：
- MacOS/Linux：
~/.claude/config.json
{
"mcpServers": {
"tambo-docs": {
"command": "node",
"args": ["D:/oss/docs-mcp-server/dist/index.js"]
}
}
}
- Windows：
%APPDATA%\Claude\config.json
{
"mcpServers": {
"tambo-docs": {
"command": "node",
"args": ["D:\\oss\\docs-mcp-server\\dist\\index.js"]
}
}
}
在 Windsurf 中
创建或更新 ~/.codeium/windsurf/mcp_config.json 文件：
- MacOS/Linux：
{
"mcpServers": {
"tambo-docs": {
"command": "node",
"args": ["D:/oss/docs-mcp-server/dist/index.js"]
}
}
}
- Windows：
{
"mcpServers": {
"tambo-docs": {
"command": "cmd",
"args": ["/c", "node", "D:\\oss\\docs-mcp-server\\dist\\index.js"]
}
}
}
💻 使用示例
开发环境（热重载）
npm run dev
生产环境
npm run build
npm start
测试
npm test
可用工具
- discover_docs：自动爬取并发现所有可用的文档路径。
- fetch_docs：根据路径获取特定的文档页面。
- search_docs：在所有发现的页面中搜索特定术语的文档。
- list_sections：列出所有发现的文档章节，并按类别分组。
🔧 技术细节
该服务器基于 TypeScript 构建，并使用了以下技术：
- @modelcontextprotocol/sdk：用于实现 MCP 协议。
- cheerio：用于 HTML 解析和内容提取。
- tsx：用于在开发时快速执行 TypeScript 代码。
在使用前，需要先构建服务器：
npm install
npm run build