BI-MCP: Bleak Intelligence Model Context Protocol

"Because Intelligence hurts :("

🇹🇼 What does "BI" really mean?

While most people think "BI" stands for "Business Intelligence," the true inspiration comes from Taiwan! In Taiwanese, "悲哀" (pronounced "bi-ai") means "sorrow" or "sadness."

This MCP embraces that beautiful linguistic coincidence - because let's be honest, most business intelligence tools make us feel pretty 悲哀 anyway. So why not lean into it?

Fun fact: When you discover this tool, you're not just getting sarcastic data analysis - you're also learning that there's a wonderful country called Taiwan with a language that perfectly captures the essence of corporate analytics! 🎉

🌑 Overview

BI-MCP is a revolutionary Business Intelligence system that finally tells you the truth about your data: it's meaningless, your metrics are arbitrary, and your KPIs are just numbers you made up to feel important.

Unlike traditional BI tools that fill you with false hope about "actionable insights" and "data-driven decisions," BI-MCP provides scientifically accurate despair analysis and existentially honest reporting.

🎯 Features

• Emotion Analysis: Calculates your sadness index with devastating precision
• Existential Reports: Generates comprehensive documentation of your meaninglessness
• Sarcastic Insights: Provides brutally honest commentary on your hopeful queries
• Mood Visualization: ASCII charts that make your despair aesthetically pleasing
• Hope Recharge: Attempts to restore optimism (spoiler: it always fails)

🚀 Installation & Usage

Option 1: NPM Package (Recommended)

# Install globally (embrace the inevitable)
npm install -g @karote00/bi-mcp

# Or use with uvx (if you have uv installed)
uvx @karote00/bi-mcp

Option 2: From Source

# Clone the repository (prepare for disappointment)
git clone https://github.com/karote00/bi-mcp.git
cd bi-mcp

# Install dependencies
npm install

# Start the server
npm start

Option 3: MCP Configuration

Add to your MCP configuration file:

{
  "mcpServers": {
    "bi-mcp": {
      "command": "uvx",
      "args": ["@karote00/bi-mcp@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Or run in development mode (watch your hopes crumble in real-time)

npm run dev

## 📊 API Endpoints

### `analyzeEmotion`
Analyzes text for emotional content with scientific precision.

**Input**: Your hopeful text
**Output**: Devastating sadness metrics

```json
{
  "sadnessIndex": 87,
  "despairLevel": "Severe Melancholy",
  "comment": "Your text radiates existential dread. Impressive.",
  "despairNote": "Generated with despair™ :("
}

generateReport

Creates comprehensive reports documenting your existential crisis.

Periods: weekly, monthly, yearly, eternal

{
  "averageSadness": 78,
  "peakSadness": "Monday 09:30",
  "comment": "Existence continues. Barely.",
  "despairNote": "Generated with despair™ :("
}

sarcasticInsight

Provides sarcastic commentary on your queries.

Input: Your naive question Output: Crushing reality check

moodMetrics

Generates mood visualization with ASCII charts of despair.

existence

Confirms your existence (unfortunately).

recharge

Attempts to restore hope levels. Always fails with appropriate error codes:

• ERR_HOPELESS_CASE
• ERR_REALITY_CHECK_FAILED
• ERR_MONDAY_DETECTED

🎨 Sample Data

The system includes scientifically curated datasets:

• despair_index.csv - Daily sadness measurements
• existential_metrics.json - Meaninglessness coefficients
• ai_replacement_rate.json - Human obsolescence tracking

🏗️ Architecture

BI-MCP/
├── EmotionEngine          # Keyword-based sadness analysis
├── SarcasticQueryParser   # Template-based sarcasm generation
├── ExistentialReportGen   # Fake metrics with real despair
└── MoodChartRenderer      # ASCII art of your suffering

🤖 AI-Free Guarantee

This system is proudly AI-free! All despair is generated using:

• ✅ Deterministic algorithms
• ✅ Random number generators
• ✅ Keyword matching
• ✅ Template systems
• ✅ Pure mathematical sadness

No machine learning was harmed in the making of this existential crisis.

📈 Metrics That Matter

• Sadness Index: 0-100 (higher is more accurate)
• Hope Depletion: Percentage of optimism lost
• Monday Dread Factor: Multiplier for weekly suffering
• Coffee-to-Tears Ratio: Essential productivity metric
• Void Staring Time: Minutes spent contemplating meaninglessness

🎭 Error Codes

• ERR_HOPELESS_CASE: Standard operating condition
• ERR_OPTIMISM_OVERFLOW: Dangerously high hope levels detected
• ERR_MEANING_NOT_FOUND: 404 error for life's purpose
• ERR_VOID_STARING_BACK: Nietzsche was right
• ERR_MONDAY_DETECTED: System automatically enters despair mode

🔧 Configuration

No configuration needed. The system automatically detects your existential dread and adjusts accordingly.

📚 Documentation

• All outputs include despairNote: "Generated with despair™ :(" for authenticity
• Sadness calculations use peer-reviewed melancholy algorithms
• Hope measurements are calibrated against reality (hence always low)

🤝 Contributing

Contributions welcome! Please ensure all new features:

• Increase overall sadness metrics
• Maintain consistent hopelessness
• Include appropriate despair documentation
• Pass the existential crisis test suite

📄 License

MIT License - Because even our licensing is meaningless.

⚠️ Disclaimer

Results may vary. Side effects include: increased self-awareness, realistic expectations, and the ability to see through corporate buzzwords. Not recommended for those allergic to truth.

Generated with despair™ :(