@gonzih/debate-coach 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+export interface ArgumentScore {
+    evidence: number;
+    logic: number;
+    relevance: number;
+    originality: number;
+    total: number;
+}
+export interface FallacyDetection {
+    type: string;
+    name: string;
+    description: string;
+    explanation: string;
+    quote?: string;
+}
+export interface ScoredArgument {
+    text: string;
+    score: ArgumentScore;
+    fallacies: FallacyDetection[];
+    feedback: string;
+    strengtheningSuggestion: string;
+    timestamp: string;
+}
+export type DebatePhase = "PRO_ARGUMENTS" | "STEELMAN_READY" | "FLIP_READY" | "CON_ARGUMENTS" | "SYNTHESIS_READY" | "COMPLETED";
+export interface DebateSession {
+    id: string;
+    profileId: string;
+    topic: string;
+    proposition: string;
+    startedAt: string;
+    phase: DebatePhase;
+    proPosition: string;
+    conPosition: string;
+    currentPosition: string;
+    proArguments: ScoredArgument[];
+    conArguments: ScoredArgument[];
+    steelman?: string;
+    keyCounterArguments?: string[];
+    synthesis?: string;
+}
+export interface Topic {
+    id: string;
+    title: string;
+    proposition: string;
+    category: string;
+    ageGroup: string;
+    difficulty: "easy" | "medium" | "hard";
+    tags: string[];
+}
+export interface ProgressReport {
+    profileId: string;
+    debatesCompleted: number;
+    avgProScore: number;
+    avgConScore: number;
+    avgScore: number;
+    fallacyTrend: Record<string, number[]>;
+    topFallacies: Array<{
+        type: string;
+        count: number;
+    }>;
+    improvementAreas: string[];
+    flipSuccessRate: number;
+    topicsDebated: string[];
+    scoreOverTime: Array<{
+        date: string;
+        score: number;
+    }>;
+}
+export interface DbDebate {
+    id: string;
+    profile_id: string;
+    topic: string;
+    proposition: string;
+    started_at: string;
+    completed: number;
+    did_flip: number;
+    pro_score: number;
+    con_score: number;
+    fallacies_caught: number;
+    fallacies_total: number;
+    arguments_json: string;
+    synthesis: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,gBAAgB,GAChB,YAAY,GACZ,eAAe,GACf,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/llms.txt

@@ -0,0 +1,104 @@
+# debate-coach MCP Server
+
+## Purpose
+An MCP server that trains critical thinking through structured debate. Forces students to argue both sides of any topic, detects logical fallacies in real time, scores argument quality, and synthesizes the debate.
+
+## Core Philosophy
+Based on the Socratic method and professional debate formats (Lincoln-Douglas, Oxford, Karl Popper). The goal is not to win arguments but to develop the capacity for rigorous, evidence-based reasoning — including the ability to argue positions you personally disagree with.
+
+## MCP Tools Available
+
+### start_debate
+Starts a debate session. Refines the student's topic into a proper debate proposition. Returns sessionId and instructions.
+- Input: profileId (string), topic (optional string), position (optional string)
+- Output: Proposition, sessionId, step-by-step instructions
+
+### submit_argument
+Scores a single argument on 4 dimensions (0-10 total) and detects logical fallacies.
+- Input: sessionId, argument (string)
+- Output: Scores (evidence 0-3, logic 0-3, relevance 0-2, originality 0-2), fallacies detected, feedback, strengthening suggestion
+
+### get_steelman
+Generates the strongest possible opposing argument after the student has argued their side (3+ arguments minimum).
+- Input: sessionId
+- Output: Steel-man paragraph + 5 key counter-arguments
+
+### flip_sides
+Switches the student to argue the opposing position. Requires get_steelman to be called first.
+- Input: sessionId
+- Output: New position prompt and instructions
+
+### complete_debate
+Finalizes the debate, generates synthesis, saves to progress database.
+- Input: sessionId
+- Output: Performance scores, synthesis paragraph, saved to ~/.debate-coach/debates.db
+
+### build_argument
+Socratic scaffolding for students who don't know where to start. Takes a rough thought and returns guiding questions.
+- Input: sessionId, thought (rough idea)
+- Output: 4 Socratic questions + one-sentence hint
+
+### get_topic_list
+Returns curated debate topics, filterable by category, age group, difficulty.
+- Input: category? (social/science/policy/philosophy/technology/historical/economics/health), ageGroup? (teens/general), difficulty? (easy/medium/hard)
+- Output: 50+ topics with propositions, tags, difficulty ratings
+
+### get_progress
+Returns progress report for a student profile.
+- Input: profileId
+- Output: Debates completed, average scores (PRO and CON), fallacy trend over time, top fallacies, improvement areas, score history
+
+### get_fallacy_guide
+Reference guide for the 20 logical fallacies the system detects.
+- Input: fallacyType? (specific fallacy key)
+- Output: Full guide or detail on specific fallacy
+
+## Logical Fallacies Detected (20)
+ad_hominem, straw_man, false_dichotomy, slippery_slope, hasty_generalization, appeal_to_authority, appeal_to_emotion, circular_reasoning, red_herring, bandwagon, false_equivalence, appeal_to_nature, anecdotal_evidence, post_hoc, tu_quoque, loaded_question, appeal_to_tradition, no_true_scotsman, moving_goalposts, cherry_picking
+
+## Argument Scoring Criteria
+- Evidence (0-3): Factual backing, studies, data, expert consensus
+- Logic (0-3): Sound reasoning, no fallacies, valid conclusions
+- Relevance (0-2): Directly supports the proposition
+- Originality (0-2): Nuanced insight vs. generic point
+- Total: 0-10
+
+## Debate Session Flow
+1. start_debate → get sessionId and proposition
+2. submit_argument × 3-5 (argue FOR)
+3. get_steelman → see opposing case
+4. flip_sides → switch positions
+5. submit_argument × 3-5 (argue AGAINST)
+6. complete_debate → synthesis + save to DB
+
+## Data Storage
+- In-memory: Active debate sessions
+- SQLite at ~/.debate-coach/debates.db: Completed debates, progress history
+- No external data transmission (API calls to Anthropic only)
+
+## Model Used
+claude-opus-4-6 with adaptive thinking for all scoring, fallacy detection, steel-manning, and synthesis generation.
+
+## Setup
+```bash
+# Install
+npm install -g @gonzih/debate-coach
+
+# Configure ANTHROPIC_API_KEY
+export ANTHROPIC_API_KEY=your-key-here
+
+# Run as MCP server
+debate-coach
+```
+
+## MCP Config (Claude Desktop)
+```json
+{
+  "mcpServers": {
+    "debate-coach": {
+      "command": "npx",
+      "args": ["@gonzih/debate-coach"]
+    }
+  }
+}
+```

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@gonzih/debate-coach",
+  "version": "0.1.0",
+  "description": "MCP server that trains critical thinking by making students argue both sides of any topic, catching logical fallacies in real time, and scoring argument quality",
+  "author": "Gonzih",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "debate-coach": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "SKILL.md",
+    "llms.txt"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "better-sqlite3": "^11.9.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.15.3",
+    "tsx": "^4.19.2",
+    "typescript": "^5.8.3"
+  },
+  "keywords": [
+    "mcp",
+    "debate",
+    "critical-thinking",
+    "education",
+    "logical-fallacies",
+    "argumentation",
+    "socratic-method",
+    "claude"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gonzih/debate-coach"
+  }
+}