Windows Context MCP 🪟⚡

Windows Context MCP is a high-performance, native backend service and Model Context Protocol (MCP) server for Windows. It exposes real-time PC activity, focused foreground application telemetry, system resource stats, and historical productivity analytics to AI agents like Google Gemini, OpenAI ChatGPT, and Claude.

🌟 Backend Features & Architecture

• 🗄️ Zero-Dependency SQLite Time-Series Engine (src/db.ts): Built on native node:sqlite for high-throughput persistence, indexed minute-by-minute focus session recording, and fast historical aggregations.

• 🔄 Dual Transport Support:

  • Streamable HTTP / JSON-RPC 2.0 (src/server.ts): REST + JSON-RPC on port 3001 for remote AI assistants (Gemini remote MCP & ChatGPT Actions).

  • Native STDIO Transport (src/stdio.ts): Fast standard I/O stream for Claude Desktop, Cursor, and local CLI agents (node dist/index.js --stdio).

• 🪟 Win32 Native Interop (src/collector.ts): Direct User32 / CIM queries for active window titles, process binaries, CPU delta utilization, RAM usage, user idle detection, and battery telemetry.

• 📈 Advanced Productivity & Transition Tracking (src/tracker.ts): Hourly breakdown curves, 24-hour timelines, transition chains, and multi-day date range analytics.

• 🧪 Automated Test Suite: 17 unit and integration tests across storage, telemetry, and tools (npm test).

Related MCP server: AETHER_01

🛠️ MCP Tools Reference (12 Tools)

🚀 Quick Start

1. Build

npm install
npm run build

2. Run Tests

npm test

3. Run Backend in HTTP Mode (for Gemini & ChatGPT)

npm start

HTTP server starts on port 3001 with endpoint http://localhost:3001/mcp.

4. Run Backend in STDIO Mode (for Claude Desktop & Local MCP Clients)

node dist/index.js --stdio

🔗 Claude Desktop Configuration (claude_desktop_config.json)

{
  "mcpServers": {
    "windowsContext": {
      "command": "node",
      "args": ["C:/Users/smnk2/.gemini/antigravity/scratch/windows-context-mcp/dist/index.js", "--stdio"]
    }
  }
}

🔗 Google Gemini Configuration

{
  "mcpServers": {
    "windowsContext": {
      "url": "http://localhost:3001/mcp",
      "transport": "http"
    }
  }
}

📄 License

MIT License.