🚀 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 憑證即可正常工作
📄 許可證
文檔中未提及相關內容,故跳過該章節。
🔐 安全注意事項