上下文解析引擎

flowchart LR
    subgraph Client[Client Layer]
        Query[Natural Language Query]
    end
    
    subgraph Engine[MCP Context Engine]
        NLP[NLP Parser]
        Intent[Intent Classifier]
        Providers[Data Providers]
        Avail[Availability Engine]
    end
    
    subgraph Sources[External Sources]
        GCal[Google Calendar]
        GitHub[GitHub API]
        Notion[Notion API]
    end
    
    Query --> NLP
    NLP --> Intent
    Intent --> Providers
    Providers --> GCal
    Providers --> GitHub
    Providers --> Notion
    GCal --> Avail
    GitHub --> Avail
    Notion --> Avail
    Avail --> Response[AI-Ready Context]

sequenceDiagram
    participant U as User
    participant API as FastAPI
    participant NLP as NLP Engine
    participant Cal as Calendar Provider
    participant Avail as Availability Engine

    U->>API: POST /query "am I free tomorrow at 3pm?"
    API->>NLP: Parse natural language
    NLP->>Cal: Fetch events for date range
    Cal-->>NLP: Return events
    NLP->>Avail: Check conflicts
    Avail-->>API: availability: busy/free
    API-->>U: JSON response with context

src/app/
├── core/                   # Business logic
│   ├── config.py           # Environment settings
│   ├── nlp.py              # Natural language parsing
│   ├── timeparse.py        # Time expression handling
│   ├── availability.py     # Conflict detection engine
│   └── intent.py           # Query intent classification
├── providers/              # External data sources
│   ├── calendar_ics.py     # Google Calendar ICS
│   ├── github.py           # GitHub API provider
│   └── notion.py           # Notion API provider
├── routers/                # API endpoints
│   ├── query.py            # Main context endpoint
│   └── debug.py            # Diagnostics routes
└── main.py                 # FastAPI entrypoint

# Clone repository
git clone https://github.com/rishabh23rohil/mcp-context-engine.git
cd mcp-context-engine

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Configure environment
cp .env.example .env
# Edit .env with your Google Calendar ICS URL

uvicorn src.app.main:app --reload --port 8000

{
  "availability": "busy",
  "conflicts": [
    {"title": "Team Meeting", "start": "2026-02-02T09:00:00-06:00", "end": "2026-02-02T10:00:00-06:00"}
  ],
  "explanation": "Conflicts with Team Meeting 09:00-10:00.",
  "suggested_slots": [
    {"start": "2026-02-02T10:00:00-06:00", "end": "2026-02-02T10:45:00-06:00", "reason": "earliest free segment"}
  ]
}

pytest tests -q