MCP-Context-Provider: Instructions file for Claude Code

CLAUDE.md — mcp-context-provider (v2.0 beta)

Clean rewrite from Python v1.8.x to TypeScript.

Architecture

Two core concepts:

• Contexts (static): 200–1000 tokens, manually authored, always injected at full confidence
• Instincts (learned): 20–80 tokens, distilled from sessions, confidence-scored (0.0–1.0), human-approved

Four subsystems:

• Engine — loads, matches, and merges contexts + instincts into injection payloads
• MCP Server (src/server/index.ts) — stdio + HTTP transport, 6 MCP tools
• CLI (mcp-cp) — approval registry for instinct lifecycle management
• Memory Bridge — syncs instincts to mcp-memory-service via HTTP API

Project Structure

src/
  server/             MCP Server (stdio + HTTP transport)
    index.ts          Entry point, tool handlers, transport selection
  types/              TypeScript type definitions
    instinct.ts       Instinct, OutcomeEntry, InstinctCandidate, InstinctQuery
    context.ts        Context, StoreTrigger, RetrieveTrigger, ContextMetadata
    index.ts          Re-exports
  schema/             Zod validation schemas
    instinct.schema.ts
    context.schema.ts
  config/             Path resolution
    paths.ts          Store/contexts path resolution (shared by server + CLI)
  engine/             Core engines
    engine.ts         Unified Engine (contexts + instincts + memory bridge)
    context-loader.ts JSON context discovery + validation
    context-matcher.ts Tool-pattern matching with glob support
    instinct-loader.ts YAML load/save with Zod validation
    instinct-matcher.ts Regex trigger-pattern matching
  bridge/             Memory Bridge (mcp-memory-service integration)
    types.ts          IMemoryBridge interface, config, response types
    http-bridge.ts    HTTP implementation (fetch-based, zero deps)
    sync.ts           Bidirectional YAML ↔ Memory sync
  cli/                Approval Registry CLI (mcp-cp)
    index.ts          CLI entry point + argument parser
    registry.ts       approve/reject/tune/outcome/remove operations
    formatter.ts      ANSI terminal formatting

hooks/                Claude Code hooks
  instill-trigger.js  Auto-detect corrections/failures → nudge /instill
instincts/            learned.instincts.yaml — the one instinct store
contexts/             JSON context files (*_context.json)
.claude/skills/       Claude Code skills
  instill.md          /instill — distill instincts from session