Skip to main content
Glama
karansinghverma979

Antigravity Campaigns MCP Server

by karansinghverma979
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

⚔️ ANTIGRAVITY CAMPAIGNS MCP SERVER

Authoritative SQLite State-Machine & Multi-Minister Tactical Operating System for AI Agents

📑 Table of Contents

Related MCP server: DataBook

✨ Core Capabilities

  • 🏛️ 4-Minister Governance Model: Directive assignment across specialized domains:

    • Adhipati: Macro-Strategy, Legal, Recruitment, High-Order Decisions.

    • Bhakta: Devotion to Duty, Physical Execution, Daily Disciplines, Coding.

    • Antaryami: Inner Observer, Self-Reflection, Psychological Constitution, Alignment.

    • Jigyasu: Intellectual Mastery, 366 Laws, Engineering Exploration.

  • ⚡ High-Speed Relational Engine: Direct SQLite access in WAL mode with sub-millisecond query latency.

  • 🌳 Hierarchical Subtask Trees: Multi-level subtasks (Initiated ➔ Doing ➔ Completed / Failed).

  • 🎯 Daily Tactical Strikes: Track daily battle directives with strict completion status (NEUTRALIZED).

  • 🩺 Automated Health Auditor: campaigns_audit_health detects orphaned strikes, overdue deadlines, and stale directives in a single pass.

  • 🛡️ Zero Secret / Data Leaks: Database location is fully configurable; schemas and initializers keep personal state isolated.

🏛️ System Architecture

┌────────────────────────────────────────────────────────────────────────┐
│                        AI AGENT RUNTIME ENGINE                         │
│               (Antigravity CLI / Claude Desktop / Cursor)              │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │ JSON-RPC (stdio)
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                   CAMPAIGNS MCP SERVER (server.py)                     │
├────────────────────────────────────────────────────────────────────────┤
│ 🛡️ Strict Whitelist & Type Sanitizer (Foreign Key Enforcement)        │
├───────────────────────────────────┬────────────────────────────────────┤
│ 📋 Task Lifecycle Engine          │ 🎯 Daily Strike Coordinator        │
│ 🌳 Subtask Hierarchy Manager      │ 🏷️ Taxonomy & Tag Indexer          │
│ 🩺 Health & Integrity Auditor     │ ⚡ Unrestricted SQL Engine         │
└───────────────────────────────────┬────────────────────────────────────┘
                                    │ SQLite Driver (WAL Mode)
                                    ▼
┌────────────────────────────────────────────────────────────────────────┐
│                   CAMPAIGNS RELATIONAL DATABASE                        │
│             `%APPDATA%\Campaigns\Database\campaigns.sqlite`             │
│            [ Tasks · Subtasks · Strikes · Tags · Recurrences ]         │
└────────────────────────────────────────────────────────────────────────┘

🛠️ Tool Catalog (14 Operations)

Category

MCP Tool Name

Description

🩺 Health & HUD

campaigns_get_dashboard

Live overview of active campaigns, pending strikes, and operational health.

campaigns_audit_health

Full database integrity scan: checks orphan strikes, broken foreign keys, and overdue dates.

📋 Tasks

campaigns_list_tasks

List and filter campaigns by state (Arsenal, Execution, Breach, Archive), stage, or priority.

campaigns_get_task_details

Deep query returning task attributes, subtask tree, connected strikes, and tags.

campaigns_create_task

Create a new campaign with priority, state stage, origin date, and deadline.

campaigns_update_task

Update task fields (state transitions, deadlines, stages) with relational integrity.

campaigns_delete_task

Cascade deletion of a campaign and its associated subtasks and strikes.

🎯 Strikes

campaigns_list_strikes

List daily strikes filtered by execution date (DD-MM-YYYY), status, or Minister.

campaigns_create_strike

Create a daily tactical strike assigned to a Minister with recurrence ID support.

campaigns_update_strike

Update strike status (STANDBY, ENGAGED, NEUTRALIZED, ABORTED), date, or notes.

campaigns_delete_strike

Remove a strike from the tactical schedule.

🌳 Subtasks & Tags

campaigns_manage_subtask

Create, update status (Initiated/Doing/Completed), or delete subtask nodes.

campaigns_manage_tag

Attach or detach uppercase taxonomy tags (GOVT, RECRUITMENT, INFRASTRUCTURE).

⚡ SQL Engine

campaigns_execute_sql

Execute unrestricted custom SQL queries and transactions with automatic rollback safety.

📊 Database Schema & LifeCycle

State Lifecycle Machine

┌─────────────┐       ┌───────────────┐       ┌────────────┐       ┌─────────────┐
│   Arsenal   │ ───►  │   Execution   │ ───►  │   Breach   │ ───►  │   Archive   │
│ (Raw Intel) │       │   (Active)    │       │ (Overdue)  │       │  (Victory)  │
└─────────────┘       └───────────────┘       └────────────┘       └─────────────┘

🚀 Quickstart & Setup

1. Installation

# Clone the repository
git clone https://github.com/karansinghverma979/antigravity-campaigns-mcp.git ~/.gemini/campaigns-mcp
cd ~/.gemini/campaigns-mcp

# Install dependencies
pip install -r requirements.txt

2. Initialize Database

# Bootstrap clean schema and demo campaign
python init_db.py

⚙️ Client Configurations

Antigravity CLI

Add to your mcp_config.json or Antigravity MCP settings:

{
  "mcpServers": {
    "campaigns": {
      "command": "python",
      "args": [
        "C:\\Users\\<USER>\\.gemini\\campaigns-mcp\\server.py"
      ]
    }
  }
}

Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "campaigns": {
      "command": "python",
      "args": [
        "/path/to/campaigns-mcp/server.py"
      ]
    }
  }
}

📐 Tactical Guardrails & Invariants

  1. Strike Completion Standard: Completed strikes are strictly marked as NEUTRALIZED (never COMPLETED).

  2. Date Format Standard: Strict calendar format DD-MM-YYYY.

  3. Execution State Mandate: Any campaign in state = 'Execution' strictly requires a valid deadline.

  4. Minister Allocation: All strikes must be assigned to an active Minister (Adhipati, Bhakta, Antaryami, Jigyasu).

🧠 Official Companion Skill & Autonomous Governance

This MCP server is natively governed and orchestrated by the campaigns skill from the antigravity-custom-skills suite.

⭐ Star this repository if you run AI-driven tactical operations!

Maintained by Karan Singh Verma · Open-Source MIT License

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • DataBook

    Ethan2298
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage and query SQLite databases through MCP tools, supporting CRUD operations, schema management, and saved views.
    4 npm
    MIT

  • agent-crm

    clayton
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to manage CRM data including companies, contacts, prospects, pipelines, forecasts, and tasks via typed MCP tools, with local SQLite storage and a JSON CLI.
    MIT