AI Context MCP

<p align="center"> <img src="assets/logo.svg" alt="AI Context MCP" width="400"/> </p>

<p align="center"> <a href="https://www.npmjs.com/package/ai-context-mcp"><img src="https://img.shields.io/npm/v/ai-context-mcp?style=flat-square&color=6366f1&label=npm" alt="npm version"/></a> <a href="https://www.npmjs.com/package/ai-context-mcp"><img src="https://img.shields.io/npm/dm/ai-context-mcp?style=flat-square&color=8b5cf6&label=downloads" alt="npm downloads"/></a> <a href="https://github.com/Prathmeshkunturwar/Context_Mcp/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License"/></a> <a href="https://github.com/Prathmeshkunturwar/Context_Mcp/actions"><img src="https://img.shields.io/github/actions/workflow/status/Prathmeshkunturwar/Context_Mcp/ci.yml?style=flat-square&label=CI&color=22c55e" alt="CI"/></a> <a href="https://github.com/Prathmeshkunturwar/Context_Mcp/blob/main/TESTING.md"><img src="https://img.shields.io/badge/tests-39%20passing-22c55e?style=flat-square" alt="Tests"/></a> <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square" alt="Node.js"/></a> </p>

<p align="center"> <strong>Give your LLM real-time, version-pinned documentation instead of hallucinated APIs.</strong><br/> An MCP server that injects live docs from <strong>57+ AI/ML libraries</strong> directly into Claude, Cursor, or any MCP-compatible client. </p>

<p align="center"> 🚫 No outdated training data  ·  ✅ Zero telemetry  ·  📦 Fully local  ·  ⚡ SQLite offline cache </p>

---

Table of Contents

• Why AI Context MCP?
• Quick Start
• Setup
• Environment Variables
• Tools Reference
• Supported Libraries
• Architecture
• Contributing
• Troubleshooting
• License

---

Why AI Context MCP?

LLMs are trained on static snapshots of the web. By the time you use Claude or Cursor, its knowledge of langchain, openai, pytorch etc. is already months out of date — causing:

• ❌ Hallucinated function signatures that don't exist
• ❌ Deprecated patterns the model confidently recommends
• ❌ Silent breaking changes that crash your app at runtime

AI Context MCP solves this by fetching current docs and changelogs from GitHub at query time, ranking them semantically, and injecting them into the model's context window.

---

Quick Start

Option 1 — NPM Global Install (recommended)

npm install -g ai-context-mcp

Option 2 — Clone & Build

git clone https://github.com/Prathmeshkunturwar/Context_Mcp.git
cd Context_Mcp
npm install && npm run build

---

Setup

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "ai-context": {
      "command": "npx",
      "args": ["-y", "ai-context-mcp"],
      "env": { "GITHUB_TOKEN": "ghp_your_token_here" }
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json:

OS	Path
Windows	%APPDATA%\Claude\claude_desktop_config.json
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ai-context": {
      "command": "npx",
      "args": ["-y", "ai-context-mcp"],
      "env": { "GITHUB_TOKEN": "ghp_your_token_here" }
    }
  }
}

Cursor / Other MCP Clients

{
  "mcpServers": {
    "ai-context": {
      "command": "npx",
      "args": ["-y", "ai-context-mcp"],
      "env": { "GITHUB_TOKEN": "ghp_your_token_here" }
    }
  }
}

---

Environment Variables

Variable	Required	Description
GITHUB_TOKEN	Recommended	GitHub PAT. Without it: 60 req/hr. With it: 5,000/hr. Create one (no scopes needed).
TRANSPORT	Optional	Set to http for Express HTTP server instead of stdio.
CACHE_TTL_HOURS	Optional	Cache TTL in hours (default: 24).
PORT	Optional	HTTP port when TRANSPORT=http (default: 3000).

---

Tools Reference

resolve-library-id

Maps natural language to a registry library ID.

"LangChain JavaScript" → /langchain-ai/langchainjs

query-docs

Fetches version-pinned documentation snippets, semantically ranked using MiniLM-L6.

query-docs(libraryId: "/openai/openai-python", query: "streaming", version: "1.0.0")

get-changelog-diff

Extracts breaking changes and new features between two versions.

get-changelog-diff(libraryId: "/langchain-ai/langchainjs", fromVersion: "0.1.0", toVersion: "0.3.0")
→ 7 BREAKING CHANGES, 12 NEW FEATURES

get-source-signature

Extracts raw type/function/class signatures directly from source code.

get-source-signature(libraryId: "/langchain-ai/langchainjs", filePath: "...", entityName: "RunnableSequence")

detect-project-versions

Scans your local package.json or requirements.txt to detect installed library versions.

detect-project-versions(projectPath: "./")
→ { "langchain": "0.1.0", "@langchain/openai": "0.0.14" }

auto-migrate-codebase

Analyzes your codebase against changelog breaking changes and generates migration alerts.

auto-migrate-codebase(libraryId: "...", projectPath: "./", fromVersion: "0.1.0", toVersion: "0.3.0")

suggest-skills

Scans your project imports and recommends which libraries to look up.

suggest-skills(projectPath: "./") → ["/langchain-ai/langchainjs", "/openai/openai-node"]

---

Supported Libraries

🤖 LLM Provider SDKs

OpenAI Python · OpenAI Node.js · Anthropic Python · Anthropic TypeScript · Google Generative AI · Mistral AI · Cohere

🦾 Agent Frameworks

LangChain Python · LangChain.js · LangGraph · LlamaIndex · CrewAI · Pydantic AI · AutoGen · Letta (MemGPT) · Vercel AI SDK

🧠 ML Frameworks

PyTorch · HuggingFace Transformers · Diffusers · Accelerate · PEFT · Pydantic

⚡ Inference Engines

vLLM · llama.cpp · Ollama

🗄️ Vector Databases

ChromaDB · Qdrant · Pinecone · Weaviate

🌐 Web Frameworks

React · Next.js · Vue · Nuxt · Svelte · SvelteKit · Express · Fastify · Hono

🗃️ Database & ORM

Prisma · Drizzle · TypeORM · Mongoose

🔌 API & Validation

tRPC · Zod · Apollo Server

🧪 Testing & Infrastructure

Vitest · Playwright · Supabase JS · Firebase JS

57 libraries and growing! Run npm run add-library or open a PR to add yours.

---

Architecture

┌─────────────────────────────────────────────────────────┐
│                MCP Client (Claude / Cursor)              │
│        resolve → query → changelog → signature           │
└───────────────────────┬─────────────────────────────────┘
                        │ MCP Protocol (stdio / http)
┌───────────────────────▼─────────────────────────────────┐
│               AI Context MCP Server                      │
│                                                          │
│  ┌────────────┐  ┌────────────┐  ┌──────────────────┐   │
│  │  Registry  │  │  Fetcher   │  │ Semantic Ranker   │   │
│  │ (57 libs)  │  │ (GitHub +  │  │  (MiniLM-L6-v2)  │   │
│  └────────────┘  │  Cache)    │  └──────────────────┘   │
│                  └────────────┘                          │
│  ┌────────────┐  ┌────────────┐  ┌──────────────────┐   │
│  │ Changelog  │  │  Snippet   │  │  Source          │   │
│  │  Parser    │  │ Extractor  │  │  Signature       │   │
│  └────────────┘  └────────────┘  └──────────────────┘   │
│                                                          │
│      L1: In-Memory LRU  │  L2: SQLite (offline)         │
└───────────────────────────────────────────────────────────┘

---

Contributing

See CONTRIBUTING.md for full guidelines.

npm run dev          # ts-node with hot reload
npm test             # 39 Jest tests
npm run build        # Compile TypeScript
npm run add-library  # Interactive library adder

Project structure:

src/
├── server.ts              # Entry point
├── registry/libraries.json # Add libraries here
├── sources/               # GitHub, NPM, PyPI, HuggingFace
├── ranking/               # Semantic ranker + snippet extractor
├── cache/                 # Two-tier LRU + SQLite cache
└── tools/                 # changelog, versions, migrate, suggest

---

Troubleshooting

"Cannot find module" on start

npm run build

GitHub 403 / rate limit errors Add GITHUB_TOKEN to your env — create a token with no extra scopes.

Stale/outdated docs returned

rm -f .cache/ai-context-cache.db

First npx run hangs The MiniLM model downloads (~25MB) on first run. This is one-time only.

More help in docs/TROUBLESHOOTING.md · Open an issue

---

License

MIT © Prathmesh Kunturwar

---

<p align="center"> <a href="https://github.com/Prathmeshkunturwar/Context_Mcp/issues">🐛 Report Bug</a> · <a href="https://github.com/Prathmeshkunturwar/Context_Mcp/issues">✨ Request Feature</a> · <a href="CONTRIBUTING.md">🤝 Contribute</a> </p> <p align="center">If this saves you time, please ⭐ the repo!</p>