Worklog MCP

工作日志mcp

英语 | 日本语

简单可搜索Markdown基本工作日志MCP服务器。

设计思想

“虽然懒得记录，但我想搜索过去的解决方案。”

保持简单

• 无需数据库，全部为明文Markdown文件
• 消除复杂的设置和外部依赖
• 可移动性和可读性优先

先搜索

• 不是人类整理的AI检索信息
• 用简单的文本匹配发掘过去的见解

机能

worklog-mcp是两个MCP仅提供工具：

1. save_worklog -保存日志

作业日志，思考片段，错误解决方案按月Markdown文件（~/.worklogs/YYYY-MM.md），模板名称将采用不同的格式。

参数：

• content （必需）：日志内容
• tags （可选）：相关标签列表

保存形式:

### 2026-01-03 14:30:00
Tags: #python #mcp #refactoring

worklog-mcpをMarkdownベースに完全リファクタリング。
SQLiteを削除し、平文管理に変更。

2. search_worklogs -搜索日志

过去的Markdown对文件进行全扫描，提取与关键字相关的条目。

参数：

• query （必需）：搜索关键字（忽略大小写）

搜索逻辑：

• 在动态输入提示中单击.md按新顺序扫描文件
• 简单的文本匹配（grep行为）
• 返回整个匹配条目

安装

GitHub直接安装（建议）

# uvがない場合は先にインストール
curl -LsSf https://astral.sh/uv/install.sh | sh

# GitHubから直接インストール
uv tool install git+https://github.com/kwrkb/worklog-mcp

从本地安装

# リポジトリをクローンしてインストール
git clone https://github.com/kwrkb/worklog-mcp.git
cd worklog-mcp
uv tool install .

pip使用

pip install git+https://github.com/kwrkb/worklog-mcp

MCP用作服务器

Claude Code（claude mcp add命令）

最简单的方法是 claude mcp add 来修改标记元素的显示属性。

uvx使用（无需安装）

# グローバルに追加（すべてのプロジェクトで使用可能）
claude mcp add worklog -s user -- uvx --from git+https://github.com/kwrkb/worklog-mcp worklog-mcp-server

# プロジェクト固有で追加（現在のプロジェクトのみ）
claude mcp add worklog -- uvx --from git+https://github.com/kwrkb/worklog-mcp worklog-mcp-server

已安装

# グローバルに追加
claude mcp add worklog -s user -- worklog-mcp-server

# プロジェクト固有で追加
claude mcp add worklog -- worklog-mcp-server

追加后、claude mcp list 中所述的工具，调整墙的布局和几何形状

claude mcp list

Claude Code（手动设定）

~/.claude/settings.json 添加到：

{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kwrkb/worklog-mcp", "worklog-mcp-server"]
    }
  }
}

克劳德桌面

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kwrkb/worklog-mcp", "worklog-mcp-server"]
    }
  }
}

VS代码（房间代码/诊所）

VS Code 的MCP 来修改标记元素的显示属性Roo Code 啊Cline 等已弃用的函数的缺少的支持。 请在扩展功能的设置画面（MCP Servers）中进行如下设置。

{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/kwrkb/worklog-mcp",
        "worklog-mcp-server"
      ]
    }
  }
}

Gemini CLI

Gemini CLI 啊 gemini mcp add 编辑命令或配置文件MCP可以添加服务器。

命令添加

# グローバルに追加（すべてのプロジェクトで使用可能）
gemini mcp add -s user worklog uvx --from git+https://github.com/kwrkb/worklog-mcp worklog-mcp-server

# プロジェクト固有で追加
gemini mcp add worklog uvx --from git+https://github.com/kwrkb/worklog-mcp worklog-mcp-server

Windows 如果：

gemini mcp add -s user worklog uvx "--from" "git+https://github.com/kwrkb/worklog-mcp" "worklog-mcp-server"

手动设定

~/.gemini/settings.json（全局）或 .gemini/settings.json添加到（项目）：

{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kwrkb/worklog-mcp", "worklog-mcp-server"]
    }
  }
}

用法

Claude Code 的规格化距离的幂函数

Claude Code 那么，Claude 自动确定并保存重要信息：

• 解决错误和完成实施等重要任务
• 发现有用的调试方法
• 用户明确请求时

你没有什么要做的。 Claude 擅自记录。

Gemini CLI 或者其他AI 时（首次提示）

Gemini CLI 啊Claude Desktop 单击功能区上CLAUDE.md 在动态输入提示中单击首先，请传达以下提示：

worklog-mcp の使い方：

【いつログを保存すべきか】
- トリッキーなバグを解決したとき
- 有用なデバッグ手法を発見したとき
- 重要な実装作業を完了したとき
- 予期しない問題の解決策を見つけたとき
- 私が明示的に保存を依頼したとき

【何をログすべきか】
- 洞察と解決策に焦点を当てる（ルーチン作業は記録しない）
- コンテキストを含める：問題は何か、何がうまくいったか、何がうまくいかなかったか
- 検索性のために説明的なタグを使う（例：#python, #debugging, #git）

【ログすべきでないもの】
- ルーチンのファイル編集や書き込み
- シンプルな bash コマンド
- テスト実行
- 学習価値のない標準的な操作

【哲学】
質より量 - 後で検索する価値があるものだけを保存してください。

传达这个指示的话AI 等已弃用的函数的缺少的支持。

MCP工具示例

MCP在您查看完详细信息后，单击Claude Code、Claude Desktop、Gemini CLI 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

save_worklog - 保存日志

「Pythonのエラーハンドリングの解決策をメモ」
→ save_worklog(content="try-except でログ出力を追加することでデバッグしやすくなった", tags=["python", "debugging"])

「今日やったリファクタリングを記録」
→ save_worklog(content="server.pyをMarkdownベースに書き換え。SQLite削除でコードが150行に削減", tags=["refactoring", "mcp"])

search_worklogs - 搜索日志

「Pythonに関する過去のメモを探して」
→ search_worklogs(query="python")

「エラーハンドリングの解決策を検索」
→ search_worklogs(query="try-except")

数据位置

日志数据是 ~/.worklogs/YYYY-MM.md 中所述修改相应参数的值。

自定义目标

WORKLOG_DIR 可以在环境变量中指定自定义路径：

export WORKLOG_DIR=~/Documents/worklogs

云同步（Google Drive、Dropbox等）

可以使用符号链接在多个设备之间同步：

# Mac/Linux
ln -s ~/Google\ Drive/worklogs ~/.worklogs

# Windows (管理者PowerShell)
mklink /D "C:\Users\\.worklogs" "G:\My Drive\worklogs"

卸载和清理

卸载

# uv tool でインストールした場合
uv tool uninstall worklog-mcp

# pip でインストールした場合
pip uninstall worklog-mcp

数据清理

# デフォルト保存先の削除
rm -rf ~/.worklogs/

# カスタム保存先を使用している場合
rm -rf $WORKLOG_DIR

MCP从设置中删除

克劳德代码：

# グローバル設定から削除
claude mcp remove worklog -s user

# プロジェクト設定から削除
claude mcp remove worklog

Gemini CLI：

# グローバル設定から削除
gemini mcp remove worklog -s user

# プロジェクト設定から削除
gemini mcp remove worklog

手动删除：

• 克劳德代码： ~/.claude/settings.json
• 克劳德桌面： ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json （Windows）
• Gemini CLI： ~/.gemini/settings.json 或 .gemini/settings.json

______________________________________________________________________

worklog mcp（英语）

简单、可搜索的基于Markdown的工作日志MCP服务器。

哲学

“记录日志很乏味，但搜索过去的解决方案很有价值”

保持简单

• 没有数据库，一切都是简单的Markdown文件
• 无复杂配置或外部依赖关系
• 可移植性和可读性优先

先搜索

• 让人工智能搜索和提取信息，而不是人类组织
• 简单的文本匹配，发现过去的见解

特性

worklog-mcp仅提供2个mcp工具：

1. save_worklog -保存日志

将工作日志、思想片段和错误解决方案保存到每月的Markdown文件中(~/.worklogs/YYYY-MM.md).

参数：

• content （必填）：日志内容
• tags （可选）：相关标签列表

存储格式：

### 2026-01-03 14:30:00
Tags: #python #mcp #refactoring

Completely refactored worklog-mcp to Markdown-based.
Removed SQLite and switched to plain text management.

2. search_worklogs -搜索日志

扫描所有过去的Markdown文件并提取与关键字相关的条目。

参数：

• query （必填）：搜索关键字（不区分大小写）

搜索逻辑：

• 扫描 .md 目录中的文件（最新文件优先）
• 简单的文本匹配（类似grep的行为）
• 返回全部匹配的条目

安装

直接从GitHub安装（推荐）

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install directly from GitHub
uv tool install git+https://github.com/kwrkb/worklog-mcp

本地安装

# Clone the repository and install
git clone https://github.com/kwrkb/worklog-mcp.git
cd worklog-mcp
uv tool install .

使用pip

pip install git+https://github.com/kwrkb/worklog-mcp

用作MCP服务器

克劳德代码（Claude mcp add命令）

最简单的方法是使用 claude mcp add 命令。

使用uvx（无需安装）

# Add globally (available in all projects)
claude mcp add worklog -s user -- uvx --from git+https://github.com/kwrkb/worklog-mcp worklog-mcp-server

# Add per project (current project only)
claude mcp add worklog -- uvx --from git+https://github.com/kwrkb/worklog-mcp worklog-mcp-server

如果已安装

# Add globally
claude mcp add worklog -s user -- worklog-mcp-server

# Add per project
claude mcp add worklog -- worklog-mcp-server

添加后，您可以使用进行验证 claude mcp list:

claude mcp list

克劳德代码（手动配置）

添加到 ~/.claude/settings.json:

{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kwrkb/worklog-mcp", "worklog-mcp-server"]
    }
  }
}

克劳德桌面

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kwrkb/worklog-mcp", "worklog-mcp-server"]
    }
  }
}

VS代码（房间代码/诊所）

要在VS Code中使用MCP，请使用Roo Code或Cline等扩展。 按如下方式配置扩展设置（MCP服务器）：

{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/kwrkb/worklog-mcp",
        "worklog-mcp-server"
      ]
    }
  }
}

Gemini CLI

Gemini CLI支持通过添加MCP服务器 gemini mcp add 命令或编辑设置文件。

使用命令

# Add globally (available in all projects)
gemini mcp add -s user worklog uvx --from git+https://github.com/kwrkb/worklog-mcp worklog-mcp-server

# Add per project
gemini mcp add worklog uvx --from git+https://github.com/kwrkb/worklog-mcp worklog-mcp-server

在Windows上：

gemini mcp add -s user worklog uvx "--from" "git+https://github.com/kwrkb/worklog-mcp" "worklog-mcp-server"

手动配置

添加到 ~/.gemini/settings.json （全球）或 .gemini/settings.json （项目）：

{
  "mcpServers": {
    "worklog": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kwrkb/worklog-mcp", "worklog-mcp-server"]
    }
  }
}

用法

克劳德代码（自动记录）

在Claude Code中，Claude会自动判断并保存重要信息：

• 解决棘手的错误或完成重要工作后
• 发现有用的调试技术时
• 当您明确请求保存某些内容时

你什么都不需要做。 克劳德将自动录制。

适用于Gemini CLI和其他AI（初始提示）

对于不自动读取CLAUDE.md的环境（如Gemini CLI或CLAUDE Desktop）， 在开头提供此提示:

How to use worklog-mcp:

[When to save logs]
- After solving a tricky bug or error
- When discovering useful debugging techniques
- After completing significant implementation work
- When finding solutions to unexpected problems
- When I explicitly request to save something

[What to log]
- Focus on insights and solutions, not routine operations
- Include context: what was the problem, what worked, what didn't
- Use descriptive tags for searchability (e.g., #python, #debugging, #git)

[What NOT to log]
- Routine file edits or writes
- Simple bash commands
- Test executions
- Standard operations without learning value

[Philosophy]
Quality over quantity - save only what's worth searching later.

提供此指令后，任何AI都会在适当的时间保存日志。

MCP工具使用示例

配置MCP服务器后，可以从Claude Code、Claude Desktop或Gemini CLI获得以下工具。

save_worklog-保存日志

"Note Python error handling solution"
→ save_worklog(content="Adding log output in try-except made debugging easier", tags=["python", "debugging"])

"Record today's refactoring"
→ save_worklog(content="Rewrote server.py to Markdown-based. Removed SQLite, code reduced to 150 lines", tags=["refactoring", "mcp"])

search_worklogs-搜索日志

"Find past notes about Python"
→ search_worklogs(query="python")

"Search for error handling solutions"
→ search_worklogs(query="try-except")

数据存储位置

日志数据存储在 ~/.worklogs/YYYY-MM.md.

自定义存储位置

使用 WORKLOG_DIR 用于指定自定义路径的环境变量：

export WORKLOG_DIR=~/Documents/worklogs

云同步（谷歌云端硬盘、Dropbox等）

使用符号链接跨设备同步工作日志：

# Mac/Linux
ln -s ~/Google\ Drive/worklogs ~/.worklogs

# Windows (PowerShell as Admin)
mklink /D "C:\Users\\.worklogs" "G:\My Drive\worklogs"

卸载和清理

卸载

# If installed with uv tool
uv tool uninstall worklog-mcp

# If installed with pip
pip uninstall worklog-mcp

数据清理

# Remove default storage location
rm -rf ~/.worklogs/

# If using custom storage location
rm -rf $WORKLOG_DIR

从MCP配置中删除

克劳德代码：

# Remove from global settings
claude mcp remove worklog -s user

# Remove from project settings
claude mcp remove worklog

Gemini CLI：

# Remove from global settings
gemini mcp remove worklog -s user

# Remove from project settings
gemini mcp remove worklog

手动拆卸：

• 克劳德代码： ~/.claude/settings.json
• 克劳德桌面： ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）
• Gemini CLI： ~/.gemini/settings.json 或 .gemini/settings.json

许可证

MIT许可证