Claude Code Analysis
Claude Code Analysis MCP Server 专门用于分析和统计 Claude Code 的使用情况,提供项目统计、会话分析、费用计算等完整功能。
功能概述
| 功能模块 | 描述 |
|---|---|
| 项目扫描 | 扫描所有 Claude Code 日志文件 |
| 统计分析 | 会话、消息、Token 使用统计 |
| 费用计算 | 精确的 API 费用计算 |
| 时间维度 | 按小时/天/周/月统计 |
关键特性
- 13 个 MCP 工具 - 完整的日志分析能力
- 持久化存储 - 基于 SQLite 的统计数据库
- 增量扫描 - 只处理变更的日志,提高效率
- 轻量级 - 无需额外数据库部署
核心功能分类
1. 项目扫描与统计
scan_logs - 扫描所有 Claude Code 日志文件
- 扫描
~/.claude/projects目录下的所有项目日志 - 统计会话、消息、Token 使用和费用等信息
- 支持强制刷新模式
get_projects_summary - 获取项目摘要
- 获取所有项目的汇总信息
- 不包含会话详情,性能更好
- 适合列表展示
refresh_stats - 强制刷新统计数据
- 触发完整的日志扫描
- 更新数据库中的所有统计信息
2. 项目与会话详情
get_project_detail - 获取项目详情
- 获取指定项目的完整信息
- 包括所有会话列表、工具使用统计、费用明细等
get_session_detail - 获取会话详情
- 获取指定会话的完整信息
- 包括消息历史、API 调用记录、工具调用详情等
3. 时间维度统计
get_hourly_stats - 按小时统计
- 获取指定日期的 24 小时统计数据
- 包括每小时的消息数、Token 使用和费用
get_daily_stats - 按天统计
- 获取指定周期的每日统计数据
- 支持周/月/上月三种周期
4. 扫描控制
trigger_scan - 触发扫描
- 手动触发日志扫描
- 支持异步、同步、守护进程三种模式
get_scan_status - 获取扫描状态
- 获取当前扫描进程的状态信息
- 包括是否正在运行、守护进程状态等
stop_scan_daemon - 停止扫描守护进程
- 停止正在运行的扫描守护进程
5. 费用计算辅助
calculate_cost - 计算 API 费用
- 根据 Token 使用情况和模型名称计算费用
- 支持缓存读取和写入的费用计算
get_model_pricing - 获取模型定价
- 获取指定 Claude 模型的定价信息
- 返回每百万 Token 的美元价格
MCP 工具列表
| 分类 | 工具名 | 功能说明 |
|---|---|---|
| 项目扫描 | scan_logs | 扫描所有日志文件并统计 |
| 项目扫描 | get_projects_summary | 获取项目摘要列表 |
| 项目扫描 | refresh_stats | 强制刷新统计数据 |
| 项目详情 | get_project_detail | 获取单个项目详情 |
| 项目详情 | get_session_detail | 获取单个会话详情 |
| 时间统计 | get_hourly_stats | 按小时统计数据 |
| 时间统计 | get_daily_stats | 按天统计数据 |
| 扫描控制 | trigger_scan | 触发扫描操作 |
| 扫描控制 | get_scan_status | 获取扫描状态 |
| 扫描控制 | stop_scan_daemon | 停止守护进程 |
| 费用计算 | calculate_cost | 计算 API 费用 |
| 费用计算 | get_model_pricing | 获取模型定价 |
使用场景
1. 个人开发者
- 📈 了解 Claude Code 的使用情况
- 💰 监控和控制 API 费用
- 🔍 回溯历史会话和操作
2. 团队协作
- 📊 统计团队整体使用情况
- 💵 费用分摊和预算管理
- 🔎 项目维度的使用分析
3. 成本优化
- 📉 识别高消耗的会话和项目
- ⏰ 分析使用时间分布
- 🎯 优化工作流程降低成本
4. 审计与合规
- 📝 完整的操作历史记录
- 🔍 会话级别的详细审计
- 📊 生成使用报告
数据分析能力
| 能力 | 说明 |
|---|---|
| ✅ 全量扫描 | Claude Code 项目日志 |
| ✅ 统计会话 | 消息、Token 使用情况 |
| ✅ 工具调用 | 频率统计 |
| ✅ 时间维度 | 小时/天/周/月分析 |
| ✅ 项目级分析 | 详细统计 |
| ✅ 会话级分析 | 深度分析 |
费用管理能力
| 能力 | 说明 |
|---|---|
| ✅ 精确计算 | API 费用计算 |
| ✅ 多模型支持 | Claude 模型定价 |
| ✅ 缓存 Token | 费用计算 |
| ✅ 趋势分析 | 费用趋势 |
安全与特性
- 只读操作 - 所有工具仅读取日志,不修改原始数据
- 本地运行 - 服务器在本地运行,数据不上传外部
- 数据隔离 - 每个项目的数据独立存储和统计
- 持久化存储 - SQLite 数据库保存分析结果
- 增量扫描 - 支持增量更新,提高效率
提示
Claude Code Analysis 服务随 Evol 应用自动启动,无需手动配置。
