使用说明
ai日志mcp
暴露的MCP服务器 AI代理遥测 作为MCP工具，这是检测AI编码代理的首选方式。
代理直接调用三个工具，无需shell命令或JSON格式：
| 工具 | 目的 |
|---|---|
start_task |
记录新的顶级任务 |
start_subtask |
记录任务中的子步骤 |
log_interruption |
记录何时放弃或阻止进场 |
安装（一个命令）
curl -fsSL https://raw.githubusercontent.com/3n9/ai-log-mcp/main/scripts/install.sh | sh
这将安装 ai-log, ai-log-report，以及 ai-log-mcp 到 ~/.local/bin，初始化数据库，向每个检测到的代理CLI（Claude Code、Gemini CLI、OpenAI Codex、GitHub Copilot CLI）注册MCP服务器，并将MCP提示注入每个代理的全局配置文件。
覆盖安装目录： INSTALL_DIR=/usr/local/bin sh
卸载
curl -fsSL https://raw.githubusercontent.com/3n9/ai-log-mcp/main/scripts/uninstall.sh | sh
这将删除二进制文件，从所有检测到的代理CLI中注销MCP服务器，并删除注入的提示块。遥测数据库保持不变。
安装什么
| 二进制 | 来源 | 目的 |
|---|---|---|
ai-log |
人工智能遥测 | 存储后端 |
ai-log-report |
人工智能遥测 | 查询、图表、导出 |
ai-log-mcp |
此repo | MCP代理服务器 |
报告
ai-log-report summary # overall counts
ai-log-report summary --by work_type # breakdown by dimension
ai-log-report chart bar # terminal bar chart
ai-log-report dashboard # HTML dashboard (last 30 days)
ai-log-report export csv # export to stdout
MCP提示
将相应的提示复制到代理的配置文件中：
| 代理 | 文件 | 配置位置 |
|---|---|---|
| 克劳德代码 | prompts-mcp/claude-code.md |
~/.claude/CLAUDE.md |
| GitHub Copilot命令行界面 | prompts-mcp/copilot.md |
~/.copilot/copilot-instructions.md |
| Gemini CLI | prompts-mcp/gemini.md |
~/.gemini/GEMINI.md |
| OpenAI Codex命令行界面 | prompts-mcp/codex.md |
~/.codex/AGENTS.md |
或者全局安装所有提示：
curl -fsSL https://raw.githubusercontent.com/3n9/ai-log-mcp/main/scripts/install-prompts.sh | sh
完整设置指南
看 MCP_SETUP.md 用于手动配置、每个代理的详细信息和故障排除。
隐私
仅存储任务元数据。从未记录任何文件路径、源代码、提示或用户消息。
有效载荷参考
完整字段参考：请参阅 技术规格
