工作日志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-mcpMCP用作服务器
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 listClaude 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-serverWindows 如果：
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_DIRMCP从设置中删除
克劳德代码：
# グローバル設定から削除
claude mcp remove worklog -s user
# プロジェクト設定から削除
claude mcp remove worklogGemini 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 worklogGemini 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许可证