🚀 Templonix Lite
Templonix Lite 是一个强大且精简的工具包,用于提升你使用 Claude Desktop 的体验。它通过模型 - 上下文 - 协议(MCP)公开了一系列工具,包括 Google 服务、网页抓取、本地内存、知识上传和动态工作流,使 Claude 能够执行复杂的现实世界代理任务。
🚀 快速开始
本指南提供了在 Windows 或 Mac 上启动并运行该项目的所有必要步骤。
✨ 主要特性
面向所有用户(标准设置)
- 🧠 本地向量内存(FAISS):跨对话存储和检索信息。使用
/remember 保存事实;询问 "what did I tell you about X?" 来检索它们。
- 📚 知识库加载器:将文档放入文件夹,Templonix 会自动对其进行索引以进行语义搜索。
- 🔄 动态工作流:加载专家 "角色"(如销售谈判专家、营销专家等),为 Claude 提供专业知识和方法。
- 🔌 原生 Claude 工具:使用 Claude 的内置功能,如创建 Mermaid 图表、Word 文档(.docx)、PowerPoint(.pptx)等。
- 🔗 原生 SaaS 连接器:通过 Claude 的官方集成连接 Google Drive、Gmail(只读)、日历(只读)、Asana、Notion 等。
面向高级用户(需要额外设置)
- 📅 日历写入权限:通过 Google 日历 API 创建、更新和删除 Google 日历事件。
- 📧 电子邮件草稿与发送:创建 Gmail 草稿或直接发送电子邮件(通过 Gmail API 或 SMTP)。
- 🌐 Jina AI 网页抓取:可靠地抓取网页,绕过常见的机器人检测和代理问题。需要在 Jina AI 网站 购买令牌。
- 📊 Eraser.io 图表:根据文本指令生成流程图、序列图和架构图。需要在 Eraser.io 购买信用额度。
- 🛠️ 可扩展架构:使用提供的框架构建自己的 MCP 工具。
📦 安装指南
标准设置(约 15 分钟)
选择你的操作系统:
Windows 设置
前提条件
在开始之前,请确保你具备以下条件:
- Windows 10 或 11
- Python 3.10、3.11、3.12 或 3.13 — 从 python.org 下载
- Claude Desktop — 从 Anthropic 下载
- 已配置 Google 连接器:在 Claude Desktop 中,连接你的 Google 账户以使用 Gmail 和 Google 日历。这将通过 Claude 的原生集成实现对电子邮件和日历事件的只读访问。
注意:你不需要安装 Git。我们将以 ZIP 文件的形式下载代码。
步骤 1:创建项目文件夹
在你的计算机上创建以下确切的文件夹路径:
C:\Development\Templonix_Lite
你可以通过以下方式完成:
- 打开文件资源管理器
- 导航到
C:\
- 创建一个名为
Development 的新文件夹
- 在
Development 文件夹内,创建一个名为 Templonix_Lite 的文件夹
步骤 2:下载并解压代码
- 访问 Templonix Lite GitHub 页面
- 点击绿色的 Code 按钮 → Download ZIP
- 打开下载的
templonix-lite-master.zip 文件
- 在 ZIP 文件中,你会看到一个名为
templonix-lite-master 的文件夹
- 复制所有内容(文件和文件夹)从
templonix-lite-master 到 C:\Development\Templonix_Lite
你的文件夹现在应该如下所示:
C:\Development\Templonix_Lite\
├── assets\
├── config\
├── core\
├── infra\
├── templonix_mcp\
├── tests\
├── workflows\
├── bootstrap.ps1
├── bootstrap.sh
├── requirements.txt
├── README.md
└── ... (其他文件)
步骤 3:运行引导脚本
这将安装所有必需的依赖项。
- 打开 PowerShell:
- 按下
Win + X 并选择 "Windows PowerShell" 或 "Terminal"
- 或者在开始菜单中搜索 "PowerShell"
- 导航到项目文件夹:
cd C:\Development\Templonix_Lite
- 运行引导脚本:
.\bootstrap.ps1
- 等待其完成(3 - 5 分钟)。你应该会看到 "Bootstrap complete. Ready to use Templonix Lite!"
⚠️ 如果你遇到 "scripts disabled" 错误:
先运行以下命令,然后再试一次:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
提示时输入 Y。
步骤 4:构建并安装扩展
4a. 创建清单文件
清单文件告诉 Claude Desktop 如何运行 Templonix Lite。我们提供了 Windows 和 Mac 的模板,你只需复制正确的模板即可。
- 打开文件资源管理器并导航到
C:\Development\Templonix_Lite\templonix_mcp
- 你会看到两个示例文件:
mcp.windows.example.json ← 使用此文件
mcp.mac.example.json
- 复制
mcp.windows.example.json 并将副本 重命名 为 manifest.json
你的文件夹现在应该包含:
templonix_mcp/
├── manifest.json ← 你的清单文件(从 Windows 示例复制而来)
├── mcp.windows.example.json
├── mcp.mac.example.json
├── app.py
└── ...
可选:个性化设置! 在记事本中打开 manifest.json 并更改以下内容:
"display_name" — 在 Claude Desktop 中显示的名称(例如,"My AI Assistant")
"author": { "name": "..." } — 输入你自己的名字
"description" — 你自己的描述
进行任何更改后保存文件。
4b. 构建扩展包
- 打开 PowerShell
- 导航到 templonix_mcp 文件夹:
cd C:\Development\Templonix_Lite\templonix_mcp
- 运行打包命令:
mcpb pack
这将在文件夹中创建 templonix_mcp.mcpb 文件。
为什么要自己构建? 这确保了透明度,你可以检查 manifest.json 配置并确切知道正在安装的内容。没有神秘的二进制文件!
4c. 在 Claude Desktop 中安装
- 打开 Claude Desktop
- 点击 File → Settings
- 转到扩展下的 Advanced Settings
- 向下滚动并点击 Install Extension
- 导航到
C:\Development\Templonix_Lite\templonix_mcp
- 选择文件
templonix_mcp.mcpb(你刚刚创建的文件)
- 点击 Confirm 进行安装
- 重启 Claude Desktop
步骤 5:开机自动启动(可选但推荐)
这将使 Templonix Lite 在 Windows 启动时自动启动。
- 按下
Win + R 打开运行对话框
- 输入
shell:startup 并按下 Enter
- 将文件
C:\Development\Templonix_Lite\config\start-templonix-silent.vbs 复制到这个启动文件夹中
就这么简单!现在,每当你启动计算机时,Templonix Lite 将在后台静默运行。
✅ Windows 设置完成!
打开 Claude Desktop,点击 + 符号,查看 Templonix Lite 扩展是否已启用。然后询问 Claude 可用的工具。
Mac 设置
前提条件
在开始之前,请确保你具备以下条件:
- macOS 11(Big Sur)或更高版本
- Python 3.10、3.11、3.12 或 3.13 — 从 python.org 下载
- ⚠️ 不支持 Python 3.14+(许多依赖项尚未有兼容的构建版本)
- 检查你的版本:
python3 --version
- Claude Desktop — 从 Anthropic 下载
- 已配置 Google 连接器:在 Claude Desktop 中,连接你的 Google 账户以使用 Gmail 和 Google 日历。这将通过 Claude 的原生集成实现对电子邮件和日历事件的只读访问。
注意:你不需要安装 Git。我们将以 ZIP 文件的形式下载代码。
步骤 1:创建项目文件夹
在你的计算机上创建以下文件夹路径:
~/Development/Templonix_Lite
你可以通过以下方式完成:
选项 A:使用 Finder
- 打开 Finder
- 按下
Cmd + Shift + H 进入你的主文件夹
- 创建一个名为
Development 的新文件夹
- 在
Development 文件夹内,创建一个名为 Templonix_Lite 的文件夹
选项 B:使用终端
mkdir -p ~/Development/Templonix_Lite
步骤 2:下载并解压代码
- 访问 Templonix Lite GitHub 页面
- 点击绿色的 Code 按钮 → Download ZIP
- 打开下载的
templonix-lite-master.zip 文件(它可能会自动解压到你的下载文件夹)
- 在解压后的文件夹中,你会看到一个名为
templonix-lite-master 的文件夹
- 复制所有内容(文件和文件夹)从
templonix-lite-master 到 ~/Development/Templonix_Lite
你的文件夹现在应该如下所示:
~/Development/Templonix_Lite/
├── assets/
├── config/
├── core/
├── infra/
├── templonix_mcp/
├── tests/
├── workflows/
├── bootstrap.ps1
├── bootstrap.sh
├── requirements.txt
├── README.md
└── ... (其他文件)
步骤 3:运行引导脚本
这将安装所有必需的依赖项。
- 打开 终端:
- 按下
Cmd + Space,输入 "Terminal",然后按下 Enter
- 或者在应用程序 → 实用工具 → 终端中找到它
- 导航到项目文件夹:
cd ~/Development/Templonix_Lite
- 使引导脚本可执行(仅需执行一次):
chmod +x bootstrap.sh
- 运行引导脚本:
./bootstrap.sh
- 等待其完成(3 - 5 分钟)。你应该会看到 "Bootstrap complete. Ready to build Templonix."
⚠️ 如果你遇到 "permission denied" 错误:
确保你在步骤 3 中运行了 chmod +x bootstrap.sh 命令。
⚠️ 如果你遇到 "python: command not found" 错误:
在 Mac 上,Python 3 通常称为 python3。编辑 bootstrap.sh 文件,将 python 更改为 python3,然后再次运行。
步骤 4:构建并安装扩展
4a. 创建清单文件
清单文件告诉 Claude Desktop 如何运行 Templonix Lite。我们提供了 Windows 和 Mac 的模板,你只需复制正确的模板即可。
- 打开 Finder 并导航到
~/Development/Templonix_Lite/templonix_mcp
- 你会看到两个示例文件:
mcp.windows.example.json
mcp.mac.example.json ← 使用此文件
- 复制
mcp.mac.example.json 并将副本 重命名 为 manifest.json
或者通过终端:
cd ~/Development/Templonix_Lite/templonix_mcp
cp mcp.mac.example.json manifest.json
你的文件夹现在应该包含:
templonix_mcp/
├── manifest.json ← 你的清单文件(从 Mac 示例复制而来)
├── mcp.windows.example.json
├── mcp.mac.example.json
├── app.py
└── ...
重要:在文本编辑器(如 TextEdit 或 VS Code)中打开 manifest.json,并将 USERNAME 替换为你实际的 Mac 用户名。
要查找你的用户名,打开终端并输入 whoami。
例如,如果你的用户名是 sarah,将:
"/Users/USERNAME/Development/Templonix_Lite/.venv/bin/python"
更改为:
"/Users/sarah/Development/Templonix_Lite/.venv/bin/python"
可选:个性化设置! 在编辑时,你还可以更改以下内容:
"display_name" — 在 Claude Desktop 中显示的名称(例如,"My AI Assistant")
"author": { "name": "..." } — 输入你自己的名字
"description" — 你自己的描述
进行任何更改后保存文件。
4b. 构建扩展包
- 打开 终端
- 导航到 templonix_mcp 文件夹:
cd ~/Development/Templonix_Lite/templonix_mcp
- 运行打包命令:
mcpb pack
这将在文件夹中创建 templonix_mcp.mcpb 文件。
为什么要自己构建? 这确保了透明度,你可以检查 manifest.json 配置并确切知道正在安装的内容。没有神秘的二进制文件!
4c. 在 Claude Desktop 中安装
- 打开 Claude Desktop
- 点击 Claude(菜单栏)→ Settings(或按下
Cmd + ,)
- 转到扩展下的 Advanced Settings
- 向下滚动并点击 Install Extension
- 导航到
~/Development/Templonix_Lite/templonix_mcp
- 选择文件
templonix_mcp.mcpb(你刚刚创建的文件)
- 点击 Confirm 进行安装
- 重启 Claude Desktop
步骤 5:登录时自动启动(可选)
在 Mac 上有两种自动启动 Templonix Lite 的选项:
选项 A:可双击的启动器(最简单)
使用提供的 start-templonix.command 文件在需要时手动启动 Templonix:
- 在 Finder 中,导航到
~/Development/Templonix_Lite/config
- 双击
start-templonix.command
- 如果你看到安全警告,转到 系统偏好设置 → 安全与隐私 → 点击 仍然打开
你可以将此文件添加到 Dock 以便快速访问。
选项 B:登录时自动启动(LaunchAgent)
要使 Templonix 在你登录时自动启动:
- 打开终端并运行:
cp ~/Development/Templonix_Lite/config/com.templonix.lite.plist ~/Library/LaunchAgents/
- 加载 LaunchAgent:
launchctl load ~/Library/LaunchAgents/com.templonix.lite.plist
要在以后停止自动启动:
launchctl unload ~/Library/LaunchAgents/com.templonix.lite.plist
rm ~/Library/LaunchAgents/com.templonix.lite.plist
✅ Mac 设置完成!
打开 Claude Desktop,点击 + 符号,查看 Templonix Lite 扩展是否已启用。然后询问 Claude 可用的工具。
高级设置
此部分适用于需要电子邮件/日历写入权限、网页抓取或图表生成的用户。适用于 Windows 和 Mac。
1. Google APIs(日历和 Gmail 写入权限)
这允许直接从 Claude 创建日历事件和起草/发送电子邮件。需要进行 Google Cloud Console 配置。
📋 点击展开 Google API 设置说明
前提条件
步骤 1:创建 Google Cloud 项目
- 访问 Google Cloud Console
- 点击 Select a project → New Project
- 命名项目(例如,
Templonix-Lite)并点击 Create
- 创建完成后选择该项目
步骤 2:启用 API
- 在控制台中搜索 API Library
- 搜索并 启用 以下 API:
步骤 3:配置 OAuth 同意屏幕
- 转到 APIs & Services → OAuth consent screen
- 选择 External 并填写表单:
- 应用名称:
Templonix-Lite
- 用户支持电子邮件:你的电子邮件
- 联系电子邮件:你的电子邮件
- 点击 Create
步骤 4:添加测试用户
- 在 OAuth 同意屏幕中,转到 Audience
- 在 Test users 下,添加你的电子邮件地址
- 保存
步骤 5:创建 OAuth 凭证
对于日历:
- 转到 APIs & Services → Credentials
- + Create Credentials → OAuth client ID
- 应用类型:Desktop app
- 名称:
Templonix-Calendar
- 下载 JSON 文件并保存为
credentials.json 在你的 Templonix 文件夹中:
- Windows:
C:\Development\Templonix_Lite
- Mac:
~/Development/Templonix_Lite
对于 Gmail:
- 重复上述步骤
- 名称:
Templonix-Gmail
- 下载 JSON 文件并保存为
credentials_gmail.json 在同一文件夹中
步骤 6:首次认证
首次使用日历或电子邮件工具时,浏览器窗口将打开进行 OAuth 授权。完成流程后,令牌将自动保存。
设置后的文件结构
Templonix_Lite/
├── credentials.json ← 日历 OAuth 配置
├── credentials_gmail.json ← Gmail OAuth 配置
├── token.json ← 日历认证令牌(自动创建)
├── token_gmail.json ← Gmail 认证令牌(自动创建)
└── ...
故障排除
"Access blocked: This app's request is invalid"
- 确保你已配置 OAuth 同意屏幕
- 验证你的电子邮件已添加为测试用户
"App not verified" 警告
- 这对于处于测试模式的应用是正常的
- 点击 Advanced → Go to [App Name] (unsafe) → 继续
令牌刷新错误
- 删除
token.json 或 token_gmail.json 并重新认证
安全注意事项
切勿将凭证或令牌文件提交到 Git。它们已包含在 .gitignore 中。
2. 环境变量(.env 文件)
对于高级功能,在你的 Templonix 文件夹中创建一个 .env 文件:
- Windows:
C:\Development\Templonix_Lite\.env
- Mac:
~/Development/Templonix_Lite\.env
# ─────────────────────────────────────────────────
# 高级功能(可选)
# ─────────────────────────────────────────────────
# SMTP 电子邮件发送(需要 Google 应用密码)
# 获取应用密码:https://myaccount.google.com/apppasswords
GOOGLE_EMAIL_ADDRESS="your-email@gmail.com"
GOOGLE_EMAIL_PSWD="your-16-character-app-password"
GOOGLE_EMAIL_SMTP_SERVER="smtp.gmail.com"
GOOGLE_EMAIL_MAIL_PORT="587"
# Jina AI 网页抓取
# 获取 API 密钥:https://jina.ai/
JINA_API_KEY="your-jina-api-key"
# Eraser.io 图表
# 从 Eraser.io 账户设置中获取 API 令牌
ERASER_API_TOKEN="your-eraser-api-token"
💻 使用示例
内存系统
| 命令 |
功能 |
/remember [fact] |
将信息存储在本地内存中 |
| "What did I tell you about X?" |
搜索存储的记忆 |
| "Search all for X" |
搜索记忆和知识库 |
工作流
"List available workflows" → 查看可用的专家模式
"Load sales_negotiator" → 激活销售谈判专家模式
知识库
- 将文档(PDF、TXT、MD、DOCX)放在
knowledge 文件夹中:
- Windows:
C:\Development\Templonix_Lite\knowledge
- Mac:
~/Development/Templonix_Lite\knowledge
- 要求 Claude "load knowledge base" 或使用
knowledge_load 工具
- 使用 "search all for [topic]" 进行搜索
原生 Claude 功能(无需额外设置)
Claude Desktop 已经提供了这些功能,可与 Templonix 一起使用:
- Google Drive — 读取和搜索你的文档
- Gmail — 读取电子邮件并搜索收件箱
- Google 日历 — 查看即将到来的事件
- Asana、Notion、Slack — 通过 Claude 的集成菜单进行连接
- 创建文档 — 要求 Claude 创建
.docx、.pptx、Mermaid 图表等
📚 详细文档
项目结构
Templonix_Lite/
├── templonix_mcp/
│ ├── app.py # 主 MCP 服务器
│ └── templonix_mcp.mcpb # 由你构建(在设置过程中创建)
├── core/
│ └── tools/ # 电子邮件、日历、Gmail 工具
├── infra/
│ └── memory/ # FAISS 内存管理器和知识库加载器
├── workflows/ # 专家工作流提示
├── knowledge/ # 放置文档以进行索引
├── config/
│ ├── start-templonix-silent.vbs # Windows 自动启动
│ ├── start-templonix.command # Mac 可双击的启动器
│ └── com.templonix.lite.plist # Mac LaunchAgent
├── bootstrap.ps1 # Windows 设置脚本
├── bootstrap.sh # Mac/Linux 设置脚本
├── requirements.txt
└── .env # 你的配置(为高级功能创建)
可用工具参考
核心工具(始终可用)
| 工具 |
描述 |
workflow_list |
显示可用的专家工作流 |
workflow_load |
激活特定的工作流 |
archive_insert |
将信息存储在本地内存中 |
archive_search |
搜索对话记忆 |
archive_search_all |
搜索记忆和知识库 |
archive_stats |
查看内存数据库统计信息 |
archive_purge |
清除记忆(谨慎使用) |
knowledge_load |
从知识库文件夹中索引文档 |
knowledge_stats |
查看知识库统计信息 |
高级工具(需要额外设置)
| 工具 |
要求 |
描述 |
calendar_create_event |
Google API |
创建日历事件 |
calendar_upcoming_events |
Google API |
列出即将到来的事件 |
calendar_delete_event |
Google API |
删除日历事件 |
email_send |
SMTP 配置 |
直接发送电子邮件 |
email_save_draft |
Gmail API |
创建电子邮件草稿 |
jina_search |
Jina API 密钥 |
抓取网页 |
diagram_create |
Eraser API |
生成图表 |
🐛 故障排除
Windows 问题
运行 bootstrap.ps1 时出现 "scripts disabled" 错误
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Python 未被识别
- 确保 Python 已安装并添加到 PATH
- 尝试运行
python --version 进行验证
Mac 问题
运行 bootstrap.sh 时出现 "permission denied" 错误
chmod +x bootstrap.sh
"python: command not found" 错误
- 在 Mac 上,尝试使用
python3 代替 python
- 编辑
bootstrap.sh 文件,将 python 更改为 python3
"command not found: pip" 错误
- 使用
pip3 代替 pip
- 或者运行:
python3 -m pip install -r requirements.txt
打开 .command 文件时出现安全警告
- 转到 系统偏好设置 → 安全与隐私 → 通用
- 点击被阻止应用消息旁边的 仍然打开
通用问题
Claude 看不到 Templonix 工具
- 验证
.mcpb 扩展是否已安装在 Claude Desktop 中
- 重启 Claude Desktop
- 检查 Templonix 服务器是否正在运行
内存搜索无结果
- 检查
archive_stats 以验证条目是否存在
- 尝试更广泛的搜索词
"credentials.json not found" 错误
- 这仅影响高级功能(日历/Gmail 写入权限)
- 标准功能无需 Google API 凭证即可正常工作
📄 许可证
文档中未提及相关内容,故跳过该章节。
🔐 安全注意事项