Metadata-Version: 2.4
Name: vibe-sunsang-mcp
Version: 0.1.2
Summary: Local MCP server for vibe-sunsang analysis workflows.
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: mcp[cli]
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"

# vibe-sunsang-mcp

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

## Install

Published package:

- [PyPI: `vibe-sunsang-mcp`](https://pypi.org/project/vibe-sunsang-mcp/0.1.2/)

```bash
uvx vibe-sunsang-mcp install
```

Or install it into a local environment:

```bash
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

```bash
vibe-sunsang-mcp
```

## CLI Helpers

```bash
.venv/bin/python -m vibe_sunsang_mcp archive-logs --platform all --mode incremental
.venv/bin/python -m vibe_sunsang_mcp analyze-session --session-id claude-xxxxxxxxxxxx
.venv/bin/python -m vibe_sunsang_mcp get-mentoring --session-id claude-xxxxxxxxxxxx
.venv/bin/python -m vibe_sunsang_mcp generate-report --platform all
.venv/bin/python -m vibe_sunsang_mcp generate-report --platform all --compare-with 2026-04-01T00:00:00Z
.venv/bin/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

```bash
.venv/bin/python -m pytest
.venv/bin/python -m ruff check src tests
```

## Gold Set

```bash
.venv/bin/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/`](/Users/cheonjaewon/Desktop/jaewon/workspace/vibe-sunsang/tests/gold-set/).

## Scope

Supported platforms:

- Claude Code
- Gemini CLI
- Codex CLI
