Aletha知识库MCP
一个MCP（模型上下文协议）服务器，将Claude Code连接到Aletha的Google Drive知识库。
快速入门（Aletha团队）
单线安装（Claude桌面版）
打开终端并运行：
curl -fsSL https://raw.githubusercontent.com/alethainc/aletha-knowledge-base-mcp/main/installer/install.sh | bash然后重新启动Claude Desktop。
手动安装（克劳德代码）
- 克隆此仓库并安装：
git clone git@github.com:alethainc/aletha-knowledge-base-mcp.git
cd aletha-knowledge-base-mcp
npm install && npm run build- 从团队成员处获取配置文件并保存到：
~/.config/aletha-mcp/config.json- 使用您的Google帐户进行身份验证：
npm run auth- 注册克劳德代码：
claude mcp add aletha-knowledge-base -- node "$(pwd)/dist/index.js"- 验证它是否有效：
claude mcp list______________________________________________________________________
特性
- 搜索文档 -在知识库中按关键字查找文档
- 浏览文件夹 -浏览文件夹结构
- 阅读文档 -将文档内容加载到Claude的上下文中
- 核心文件 -快速访问基本的、预先配置的文档
- 多种格式 -支持谷歌文档、表格、幻灯片、PDF和Office文件
先决条件
- Node.js 18+
- 启用了Drive API的Google Cloud项目
- OAuth 2.0凭据（桌面应用程序类型）
- 访问目标Google Drive文件夹/共享驱动器
安装
- 克隆和安装依赖关系：
cd aletha-knowledge-base-mcp
npm install- 构建项目：
npm run build- 设置Google Cloud凭据：
- 首选 谷歌云控制台 - 创建新项目或选择现有项目 - 启用 Google Drive API - 首选 凭证 > 创建凭据 > OAuth 2.0客户端ID - 选择 桌面应用程序 作为应用程序类型 - 下载凭据
- 配置MCP：
创建 ~/.config/aletha-mcp/config.json:
{
"knowledgeBase": {
"rootFolderId": "YOUR_FOLDER_ID",
"rootFolderName": "Aletha Knowledge Base",
"type": "folder"
},
"google": {
"clientId": "YOUR_CLIENT_ID.apps.googleusercontent.com",
"clientSecret": "YOUR_CLIENT_SECRET",
"redirectUri": "http://localhost:3000/oauth/callback"
},
"defaults": {
"maxSearchResults": 10,
"outputFormat": "markdown"
}
}要查找您的文件夹ID：在Google Drive中打开文件夹，并从URL复制ID： https://drive.google.com/drive/folders/THIS_IS_THE_FOLDER_ID
- 使用Google进行身份验证：
npm run auth这将打开Google OAuth浏览器。登录并授权访问。
- 添加到克劳德代码：
claude mcp add aletha-knowledge-base -- node "/path/to/aletha-knowledge-base-mcp/dist/index.js"验证它是否已连接：
claude mcp list用法
安装后，在与Claude对话时自然使用这些命令：
搜索文档
“在知识库中搜索品牌指南” “查找有关入职培训的文档” “在知识库中查找PTO政策”
浏览文件夹
“列出知识库中的文件夹” “显示营销文件夹中的内容” “浏览根文件夹”
阅读文档
搜索后，您可以阅读完整内容：
“阅读该品牌指南文件” “将第一个文档加载到上下文中” “显示\[文档名称\]的完整内容”
列出核心文件
“核心文件是什么？” “给我看基本文件”
使用营销代理
要创建营销内容，请调用营销代理提示：
“使用营销代理提示为我们的新产品创建登录页” “收到营销代理的提示，帮我写一封营销电子邮件”
这会自动从知识库中加载品牌指南、视觉指南和营销参考，然后再帮助您完成任务。
提示
- 具体来说：“在知识库中搜索X”比“找到X”更有效
- 克劳德将使用
search_docs和read_doc自动工具 - 文档从连接的Google Drive文件夹中提取
技术参考
对于直接工具调用：
search_docs(query: "brand guidelines")
search_docs(query: "PTO policy", file_type: "document")
list_folder()
list_folder(folder_id: "abc123")
read_doc(doc_id: "abc123xyz")
list_core_docs()核心文件
在中配置常用文档 ~/.config/aletha-mcp/core-docs.json:
{
"coreDocs": [
{
"id": "1abc123xyz",
"name": "Brand Guidelines",
"description": "Logo usage, colors, typography, and brand voice",
"category": "Brand"
},
{
"id": "2def456abc",
"name": "Employee Handbook",
"description": "Company policies and procedures",
"category": "Policy"
}
]
}这些文档显示为MCP资源，可以快速加载到上下文中。
故障排除
“未找到身份验证令牌”
跑 npm run auth 通过谷歌进行身份验证。
“访问令牌已过期”
MCP会自动刷新令牌。如果失败，运行 npm run auth --force.
“找不到配置文件”
在以下位置创建配置文件 ~/.config/aletha-mcp/config.json 或设置 ALETHA_MCP_CONFIG 环境变量。
搜索未返回任何结果
- 验证文件夹ID是否正确
- 确保您的Google帐户可以访问该文件夹
- 检查文档是否不在垃圾箱中
发展
# Watch mode for development
npm run dev
# Build
npm run build
# Run directly
npm start安全
- OAuth令牌存储在本地
~/.config/aletha-mcp/tokens/ - 仅请求只读驱动器访问
- 除了Google的API之外，没有任何数据发送到外部服务