MCP编码见解
轻量级MCP服务器与入门技能相结合，使您只需询问代理即可灵活报告对编码活动的见解。这对于各种用例都很有用，从战略见解到帮助改进编码代理的使用方式，再到每日站立的快速活动摘要。
最初，此工具仅支持Claude Code。
概述
Claude Code支持 /insights 命令，生成一个关于固定时间跨度内编码活动的非常具体的报告。
此MCP服务器通过公开代理可以用来提供根据您所述要求定制的报告的工具来扩展该功能，而不是预定义的格式，如果您愿意，可以将其范围限定在特定的项目和时间跨度内。这大大拓宽了潜在的用例，并在报告的内容和呈现方面提供了极大的灵活性。
这些工具在以下位置访问相同的会话记录文件 ~/.claude/projects/随着 /insights 命令，但允许您对该会话信息进行特别报告请求。
技能
此存储库还包括一个可选的HTML编码报告器技能，可帮助Claude在您的编码活动中生成自包含的HTML报告。该技能用于根据表达的用户意图生成适当的HTML报告，使用MCP服务器检索相关的会话详细信息。
根据您的用例和偏好，您可以自由扩展或定制技能。
例子
以下只是演示此MCP服务器有用报告的几个提示示例：
generate a weekly summary report including key activities and high level breakdown of time spent on each project
summarise key pain points encountered coding this project
summarise coding activity yesterday by project in standup presentation appropriate format
for the current project rank the busiest days over the last month
provide a high level summary of subagent usage across all projects yesterday
show me all messages in the last month that reference typescript, broken down by project
快速启动
从本质上讲，此服务器旨在与Claude Code一起在开发人员笔记本电脑或工作站上本地安装和使用。
MCP服务器设置
对于以下配置，您应该 node, npm 并且安装了Claude Code（其他设置也是可能的）。
克隆此存储库，然后安装依赖项并将其配置为与Claude Code一起使用，如下所示（这将为您的所有项目全局添加它）：
cd
&& npm install
claude mcp add mcp-coding-insights --scope user -- `pwd`/node_modules/.bin/tsx `pwd`/src/index.ts然后（在系统提示时授予此服务器的权限后），您将能够向Claude询问有关您的Claude会话的各种问题——您可以从尝试上面的一些示例提示开始。
HTML报告技能设置
要启用HTML编码报告器技能，请从以下位置复制 这里 进入你的技能（例如 ~/.claude/skills/html-coding-reporter/)，重新启动克劳德。现在，您可以根据自己的意图生成HTML报告，例如，在Claude Code中尝试以下操作：
generate a HTML weekly summary report including key activities and high level breakdown of time spent on each project代理将在临时目录中生成一个HTML报告，并在浏览器中打开它。只有当你明确要求提供HTML报告时，它才会使用此技能，否则它只会向终端输出一个文本报告，这通常会更快一些，但让Claude来决定流程和步骤。
工具
list_projects--列出所有具有Claude Code转录数据的项目，包括会话计数和最后活动日期get_sessions_summary--获取会议的高级摘要（可选择特定项目和/或日期范围）get_session_logs--按项目分组的完整会话详细信息（可选用于特定项目、会话ID和/或日期/范围）list_subagents-列出按项目分组的所有子代理（可选用于特定项目和/或日期范围）get_subagent_detail-获取特定子代理的完整详细信息（用户消息、使用的工具）search_sessions-搜索特定关键字（可选地搜索特定项目和/或日期范围），返回所有匹配的用户/助理消息，最多可配置每个会话的最大计数。
性能和上下文使用
对于大多数 _“正常”_ 通过会话和查询，此MCP服务器提供了快速的结果，并具有适度的额外上下文使用影响。在没有此MCP服务器的情况下，Claude可能会尝试通过使用bash工具直接访问和解析会话记录来回答上述问题。在大多数情况下，这会导致更复杂、更慢的处理、更高的上下文使用率和更容易出错的结果，因此该服务器仍然是典型情况下的最佳选择。
但是，在某些情况下，此服务器可能会收集非常大的结果集，这对服务本身的性能以及更重要的上下文窗口都有影响。可能导致非常大的结果集的查询/报告通常涉及以下一项或多项：
- 尤其是繁重的编码会话
- 大量项目
- 宽日期范围（默认为1周，通常可以）
- 需要返回详细日志（消息内容、工具调用等）的查询
以下是处理这些情况的一些提示：
_提示#1_：尝试将查询限制到特定的项目、日期范围和/或所需的数据。
_提示#2_：最简单、可能也是最好的一般策略是启用此服务器，如果报告工具调用失败（很可能是由于工具结果超过上下文限制），让Claude处理自动回退到直接方法。
_提示#3_：为您的报告使用不同的会话，这些会话与您用于编码活动的会话是分开的——这可以确保报告的上下文使用不会影响您的编码会话，反之亦然。您甚至可以使用Claude以外的代理进行此报告，只要该代理支持本地MCP服务。
_提示#4_：使用技能捕获与Claude用例相关的上下文管理规则。例如，所包含的HTML Coding Reporter技能有明确的分步说明，以尽量减少上下文使用，在这种情况下，在按会话进行摘要时，一次加载一个会话的消息——在继续下一个会话之前，它会丢弃该会话的消息（仅保留摘要）。