matiasmoron/typescript-coach-mcp

🧠 TypeScript Docs MCP

A minimal yet powerful MCP server that provides Copilot and other clients with verified, structured answers from the official TypeScript Handbook.

No more hallucinated explanations — just real, contextual TypeScript knowledge at your fingertips.

---

🚀 Overview

TypeScript Docs MCP is a Model Context Protocol (MCP) server that provides verified, structured answers from the official TypeScript documentation (Handbook and related pages).

Its purpose is to enhance GitHub Copilot and other MCP-compatible tools by delivering precise, trustworthy information about TypeScript concepts — from basic types to advanced generics.

---

🧩 Features

• 🔍 Multi-page semantic search across the official TypeScript Handbook
• 🧠 Intelligent ranking (TF-IDF weighting + diversity + anchor injection)
• 💡 "Did you mean" suggestions for related topics
• ⚙️ Structured JSON output for MCP clients
• ⚡ Fast in-memory caching (optional LRU)
• 🪄 Compatible with GitHub Copilot and VS Code MCP integration

---

🧠 Why it matters

Most AI assistants can describe TypeScript features, but they sometimes hallucinate explanations or syntax.
This MCP eliminates that uncertainty by grounding every response in official TypeScript sources.

It ensures:

• ✅ Verified answers
• 📚 Direct references to documentation
• ⚙️ Consistent accuracy across environments

---

🧰 Installation (local development)

1. Clone this repository:

   git clone https://github.com/<your-username>/ts-coach-mcp
   cd ts-coach-mcp
   

2. Install dependencies:

   npm install
   

3. Register the MCP in your VS Code or Copilot configuration (mcp.json):

   {
     "servers": {
       "ts-coach-mcp": {
         "command": "npx",
         "args": ["-y", "tsx", "[path-to-project-folder]/ts-coach-mcp/src/index.ts"]
       }
     }
   }
   

4. Confirm it appears in your Tools panel under “ts-coach-mcp”.

---

⚙️ Usage example

In VS Code, ask Copilot or ChatGPT MCP-compatible client:

“Explain the difference between any and unknown in TypeScript”

and you’ll receive a verified summary with references to the official docs.

---

📚 Source

All responses come directly from the official TypeScript Handbook.

---

🧩 Future roadmap

• Local indexed Handbook for instant offline responses
• Advanced caching with TTL
• Project context detection (auto-activate in .ts/.tsx files)
• Expanded coverage: TSConfig and Compiler Options docs

---

🧑‍💻 Author

Built by Matías Morón — I'm a software engineer from Argentina, with +10 years of experience. Mainly working with Reactjs, Nodejs, TypeScript.

⚡ “Better answers come from better sources — that’s why we trust the TypeScript Handbook.”