MCP Work History

🚀 📋 MCP工作歷史服務器

🤖 這是一個模型上下文協議（MCP）服務器，允許AI工具將其活動記錄到每日工作日誌文件中，並詳細跟蹤工具名稱、AI模型和時間戳。

✨ 主要特性

• 🕐 精確的時間戳：以HH:MM格式記錄活動時間
• 🔧 工具跟蹤：記錄執行操作的AI工具
• 🧠 模型跟蹤：跟蹤使用的AI模型（例如，gemini - 2.5 - pro、claude - 3 - sonnet）
• 📊 全面的指標：跟蹤令牌使用量、上下文長度、持續時間和成本
• 🏷️ 標籤系統：使用自定義標籤對活動進行分類
• ✅❌ 成功/失敗跟蹤：記錄成功操作和錯誤
• 📁 每日組織：為每一天創建單獨的Markdown文件
• 📝 簡潔格式：採用項目符號樣式的條目，便於瀏覽
• 🎯 MCP兼容：可與任何支持MCP的AI客戶端配合使用

📦 安裝指南

npm install

💻 使用示例

基礎用法

啟動MCP服務器：

npm start

或者在開發模式下運行，支持自動重啟：

npm run dev

高級用法

服務器提供了一個工具：

log_activity

將AI工具的活動以簡潔、易瀏覽的格式記錄到當天的工作日誌文件中。

參數： 必需參數：

• tool_name（字符串）：AI工具的名稱（例如，“Warp”、“Claude Code”、“GitHub Copilot”）
• log_message（字符串）：詳細描述完成的操作

可選參數：

• ai_model（字符串）：使用的AI模型（例如，“gemini - 2.5 - pro”、“claude - 3 - sonnet”、“gpt - 4”）
• tokens_used（數字）：請求中消耗的總令牌數
• input_tokens（數字）：使用的輸入令牌數（可替代tokens_used）
• output_tokens（數字）：生成的輸出令牌數（可替代tokens_used）
• context_length（數字）：使用的上下文窗口長度（以千為單位）
• duration_ms（數字）：操作的持續時間（以毫秒為單位）
• cost_usd（數字）：估計的成本（以美元為單位）
• success（布爾值）：操作是否成功（默認為true）
• error_message（字符串）：操作失敗時的錯誤消息
• tags（數組）：用於對活動進行分類的標籤（例如，["coding", "debugging", "refactoring"]）

示例日誌條目：

# 📝 工作日誌 - 2024 - 01 - 15

- ✅ 08:31 - Warp (gemini - 2.5 - pro): 將身份驗證模塊重構為使用JWT令牌 (1250 令牌 | 8k 上下文 | 2.3 秒 | $0.0043 | [refactoring, auth])
- ✅ 09:15 - Claude Code (claude - 3 - sonnet): 修復了數據庫連接池問題 (850→320 令牌 | 1.1 秒 | $0.0021)
- ❌ 10:42 - GitHub Copilot (gpt - 4): 嘗試實現用戶資料端點 (❌ 超時錯誤 | [coding, api])
- ✅ 11:30 - Warp: 快速代碼審查並提出建議 (500 令牌 | 0.8 秒)

📚 詳細文檔

📂 日誌文件結構

日誌存儲在logs/目錄中，文件命名模式為worklog - YYYY - MM - DD.md。

每個日誌文件包含：

• 📝 帶有表情符號的日期標題
• 🕐 帶時間戳的項目符號條目
• 🔧 工具名稱和AI模型信息
• 📋 簡潔的活動描述

⚙️ MCP配置

對於Warp AI

將此服務器添加到您的Warp MCP配置中：

{
  "mcp - work - history": {
    "command": "node",
    "args": ["/Users/your - username/path/to/mcp - work - history/src/index.js"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

對於Claude Desktop

添加到您的claude_desktop_config.json文件中：

{
  "mcpServers": {
    "work - history": {
      "command": "node",
      "args": ["/absolute/path/to/mcp - work - history/src/index.js"]
    }
  }
}

AI工具中的示例用法

配置完成後，AI工具可以像這樣記錄其活動： 基本用法：

log_activity({
  tool_name: "Warp",
  log_message: "為用戶儀表板創建了React組件"
})

包含全面指標：

log_activity({
  tool_name: "Warp",
  ai_model: "gemini - 2.5 - pro",
  log_message: "使用OAuth集成重構了身份驗證系統",
  tokens_used: 1250,
  context_length: 8,
  duration_ms: 2300,
  cost_usd: 0.0043,
  success: true,
  tags: ["refactoring", "auth", "oauth"]
})

錯誤日誌記錄：

log_activity({
  tool_name: "GitHub Copilot",
  ai_model: "gpt - 4",
  log_message: "嘗試實現用戶資料端點",
  input_tokens: 800,
  output_tokens: 0,
  success: false,
  error_message: "超時錯誤",
  tags: ["coding", "api"]
})

🗂️ 項目結構

mcp - work - history/
├── 📄 src/index.js          # 主MCP服務器代碼
├── 📁 logs/                 # 每日工作日誌文件（自動創建）
│   ├── worklog - 2024 - 01 - 15.md
│   └── worklog - 2024 - 01 - 16.md
├── 📦 package.json          # 依賴項和腳本
├── 🚫 .gitignore           # Git忽略規則
└── 📋 README.md            # 本文件

🤝 貢獻指南

1. 分叉倉庫
2. 創建您的功能分支 (git checkout -b feature/amazing - feature)
3. 提交您的更改 (git commit -m '添加一些很棒的功能')
4. 推送到該分支 (git push origin feature/amazing - feature)
5. 打開一個拉取請求

🎯 實際示例：Warp AI集成

以下是如何在Warp AI中設置自動活動記錄的步驟：

步驟1：在Warp中配置MCP服務器

將以下內容添加到您的Warp MCP配置中：

{
  "mcp - work - history": {
    "command": "node",
    "args": ["/Users/nocoo/Workspace/mcp - work - history/src/index.js"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

步驟2：在Warp中添加日誌記錄規則

使用此規則配置Warp，以自動記錄AI活動：

規則： “當AI任務完成時，使用mcp - work - history記錄此次AI任務的詳細信息。發送AI工具名稱（Warp）、使用的模型、詳細時間以及此次任務的簡要摘要和結果。”

步驟3：查看效果

 顯示MCP工作歷史服務器在Warp中自動記錄AI活動的截圖

記錄內容

通過此設置，Warp中的每次AI交互將自動創建如下條目：

# 📝 工作日誌 - 2024 - 12 - 06

- ✅ 14:32 - Warp (gemini - 2.5 - pro): 將React組件重構為使用自定義鉤子進行狀態管理 (1240 令牌 | 4.2 秒 | [refactoring, react])
- ✅ 14:45 - Warp (gemini - 2.5 - pro): 修復了身份驗證模塊中的TypeScript類型錯誤 (890 令牌 | 2.1 秒 | [bugfix, typescript])
- ✅ 15:10 - Warp (gemini - 2.5 - pro): 為用戶服務添加了全面的單元測試 (1560 令牌 | 3.8 秒 | [testing, unit - tests])

好處

• 📊 自動跟蹤：無需手動記錄
• 🔍 詳細洞察：跟蹤令牌使用量、性能和成本
• 📈 進度監控：查看您的每日編碼成果
• 🏷️ 活動分類：使用標籤組織工作
• 💰 成本跟蹤：長期監控AI使用成本

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。