Skip to content

Add repo-local MCP asset for Microsoft Learn workspace server#2

Merged
markgar merged 1 commit into
mainfrom
markgar-ubiquitous-waddle
Jun 22, 2026
Merged

Add repo-local MCP asset for Microsoft Learn workspace server#2
markgar merged 1 commit into
mainfrom
markgar-ubiquitous-waddle

Conversation

@markgar

@markgar markgar commented Jun 22, 2026

Copy link
Copy Markdown
Owner

What

Adds a repo-scoped skill so the global workspace-mcp dispatcher can drive the Microsoft Learn HTTP MCP server (defined in .mcp.json) from inside GitHub Copilot desktop-app sessions.

.github/skills/mcp-microsoft-learn/
├── SKILL.md        # curated server knowledge: URL, transport, the 3 tools (args + examples), maintenance notes
└── mcp_proxy.py    # self-contained, stdlib-only JSON-RPC-over-HTTP engine (load / tools / call)

Why

Desktop-app sessions run with cwd ~/.copilot, so a repo's .mcp.json and .github/skills/ are not auto-discovered (cwd bug — copilot-cli #3126 / #3688). The always-loaded global workspace-mcp skill bridges this by reading repo assets on demand and calling the bundled proxy over HTTP.

Design

  • Config of record stays in the repo (.mcp.json, already on main).
  • Curated knowledge + engine live in the repo asset (version-controlled, self-contained).
  • Global dispatcher is the only piece guaranteed to auto-load; it discovers and drives the repo asset.
  • Future-proof: auto-activates natively once the upstream cwd bug is fixed — no changes needed.

Verified

python3 .github/skills/mcp-microsoft-learn/mcp_proxy.py load lists the 3 tools; a call returned live Microsoft Learn docs.

Note: the global skills (workspace-mcp, mcp-over-http) live in ~/.copilot/skills/ and are intentionally not in this repo.

Adds a repo-scoped skill that lets the global workspace-mcp dispatcher
drive the Microsoft Learn HTTP MCP server (defined in .mcp.json) inside
GitHub Copilot desktop-app sessions, where repo .mcp.json and
.github/skills are not auto-loaded due to a cwd discovery bug
(copilot-cli #3126 / #3688).

- .github/skills/mcp-microsoft-learn/SKILL.md: curated server knowledge
  (URL, transport, the 3 tools with args + examples, maintenance notes)
- .github/skills/mcp-microsoft-learn/mcp_proxy.py: self-contained,
  stdlib-only JSON-RPC-over-HTTP engine (load / tools / call)

Auto-activates natively once the upstream cwd bug is fixed.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@markgar markgar merged commit b8fe33a into main Jun 22, 2026
@markgar markgar deleted the markgar-ubiquitous-waddle branch June 22, 2026 20:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant