feat: Add experimental CLI for Learn MCP (#117)

* Add in-repo Microsoft Learn companion CLI

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address PR review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Address additional PR review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove unused zod dependency

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Remove CLI spec document

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: TianqiZhang

.github/workflows/validate.yml

@@ -8,13 +8,35 @@ on:
 
 jobs:
   validate:
-    name: Validate Claude Plugin & Skills
+    name: Validate Repository (Node ${{ matrix.node-version }})
     runs-on: ubuntu-latest
-    
+    strategy:
+      matrix:
+        node-version: [22, 24]
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: npm
+          cache-dependency-path: cli/package-lock.json
+
+      - name: Install CLI dependencies
+        working-directory: cli
+        run: npm ci
+
+      - name: Build CLI
+        working-directory: cli
+        run: npm run build
+
+      - name: Test CLI
+        working-directory: cli
+        run: npm test
+
       - name: Run validation script
         shell: pwsh
         run: ./scripts/validate-repo.ps1

.gitignore

@@ -4,5 +4,6 @@ _site/
 .optemp/
 _themes*/
 _repo.*/
-
-.openpublishing.buildcore.ps1
+node_modules/
+.openpublishing.buildcore.ps1
+.claude/settings.local.json

README.md

@@ -107,6 +107,17 @@ https://learn.microsoft.com/api/mcp?maxTokenBudget=2000
 | `microsoft_docs_fetch` | Fetch and convert a Microsoft documentation page into markdown format | `url` (string): URL of the documentation page to read |
 | `microsoft_code_sample_search` | Search for official Microsoft/Azure code snippets and examples | `query` (string): Search query for Microsoft/Azure code snippets<br/>`language` (string, optional): Programming language filter.|
 
+## 💻 Companion CLI
+
+This repository now also includes an in-repo companion CLI under [`/cli`](cli/). The `mslearn` CLI is a thin MCP client for the public Learn endpoint and adds shell-friendly commands for docs search, docs fetch, code sample search, and diagnostics.
+
+```bash
+cd cli
+npm install
+npm run build
+node dist/index.js --help
+```
+
 ## 🤖 Agent Skills
 
 [Agent Skills](https://agentskills.io/) are portable instruction packages that help AI agents use tools more effectively. We provide three skills that guide agents on when and how to use the Microsoft Learn MCP tools:

cli/.gitignore

@@ -0,0 +1,3 @@
+dist/
+node_modules/
+coverage/

cli/README.md

@@ -0,0 +1,27 @@
+# Microsoft Learn Companion CLI
+
+`mslearn` is a thin companion CLI for the public Microsoft Learn MCP server. It dynamically discovers the available Learn tools at runtime and exposes shell-friendly commands for docs search, docs fetch, code sample search, and environment diagnostics.
+
+## Commands
+
+```bash
+mslearn search "azure functions timeout"
+mslearn fetch "https://learn.microsoft.com/azure/azure-functions/functions-versions#function-app-timeout-duration" --section "Function app timeout duration"
+mslearn code-search "cosmos db change feed processor" --language csharp
+mslearn doctor
+```
+
+By default, the CLI connects to the public Microsoft Learn MCP endpoint:
+
+```text
+https://learn.microsoft.com/api/mcp
+```
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+node dist/index.js --help
+```