vibe-sunsang-mcp

Local MCP server for vibe-sunsang session analysis, mentoring context, and report generation.

Install

Published package:

• PyPI: vibe-sunsang-mcp

uvx vibe-sunsang-mcp install

Or install it into a local environment:

pip install vibe-sunsang-mcp

The installer writes:

• project .mcp.json for Claude-compatible local MCP registration
• project .gemini/settings.json
• project gemini.md
• project AGENTS.md
• home ~/.codex/config.toml

Run

vibe-sunsang-mcp

CLI Helpers

python -m vibe_sunsang_mcp archive-logs --platform all --mode incremental
python -m vibe_sunsang_mcp analyze-session --session-id claude-xxxxxxxxxxxx
python -m vibe_sunsang_mcp get-mentoring --session-id claude-xxxxxxxxxxxx
python -m vibe_sunsang_mcp generate-report --platform all
python -m vibe_sunsang_mcp generate-report --platform all --compare-with 2026-04-01T00:00:00Z
python -m vibe_sunsang_mcp generate-gold-set --labels-dir tests/gold-set

These commands call the same underlying tool implementations as the MCP server, but are useful for local archiving, gold set preparation, and smoke testing without opening a client.

MCP Tools

• archive_logs
• analyze_session
• get_mentoring
• generate_report

Development

python -m pytest
python -m ruff check src tests

Gold Set

python -m vibe_sunsang_mcp evaluate-gold-set \
  --labels-dir tests/gold-set \
  --archive-root ~/vibe-sunsang

This compares archived sessions against human-labeled files in tests/gold-set/.

Scope

Supported platforms:

• Claude Code
• Gemini CLI
• Codex CLI