betting-method-mcp: Instructions file for Claude Code

Claude AI Context - Betting Method MCP Server

This file provides context for Claude AI assistants working on this project.

Project Overview

betting-method-mcp is a Model Context Protocol (MCP) server that provides betting method calculations. It's designed to be used with Claude Desktop and other MCP-compatible clients.

Key Technologies

• TypeScript (strict mode enabled)
• Node.js (>=18)
• MCP SDK (@modelcontextprotocol/sdk)
• Vitest (testing framework)
• Biome (linter & formatter)

Architecture Principles

1. Extensibility First

• Each betting method is an independent class
• Common interfaces ensure consistency
• Easy to add new methods following established patterns

2. Type Safety

• Strict TypeScript configuration
• All betting methods extend BettingMethodState
• Comprehensive type definitions in src/types.ts

3. Consistent API Pattern

All betting methods expose 4 operations:

• {method}_init - Initialize session
• {method}_record - Record win/loss
• {method}_status - Get current state
• {method}_reset - Reset session

Code Style & Conventions

TypeScript Style

• Quotes: Double quotes (")
• Semicolons: Always required
• Indentation: 2 spaces
• Line width: 100 characters
• Trailing commas: Always
• Arrow functions: Always use parentheses

Naming Conventions

• Classes: PascalCase (e.g., MonteCarloMethod)
• Interfaces: PascalCase with State suffix (e.g., MartingaleState)
• Methods: camelCase (e.g., recordResult, initSession)
• MCP Tools: lowercase with underscore (e.g., montecarlo_init)

File Organization

src/
├── index.ts              # MCP server entry point
├── types.ts              # Shared type definitions
└── methods/
    ├── {method}.ts       # Method implementation
    └── __tests__/
        └── {method}.test.ts  # Vitest tests

Implementation Patterns

1. Betting Method Class Structure

export class MethodNameMethod {
  private state: MethodNameState;

  constructor() {
    // Initialize with default values
  }

  initSession(/* params */): void {
    // Validate parameters
    // Initialize state
  }

  recordResult(result: BetResult): void {
    // Check if session is active
    // Update state based on result
    // Calculate next bet
  }

  getState(): MethodNameState {
    // ALWAYS return a copy, not reference
    return { ...this.state };
  }

  reset(): void {
    // Reset to initial state, keeping parameters
  }
}