component-workshop

component-workshop

A minimal MCP server providing synthetic embedded components and NTC fault codes, designed for hands-on workshop exercises with GitHub Copilot Chat Agent mode.

Category
Visit Server

README

MCP Workshop

Build your first MCP server in 30 minutes.

Open in GitHub Codespaces

What's inside

A tiny MCP server that serves synthetic embedded-flavored data — fake components (like CM101A) and fake NTC fault codes — plus a .vscode/mcp.json that hands it to GitHub Copilot Chat's Agent mode as a tool source. You'll add tools during the workshop and ask Copilot to use them.

Quick start (in Codespaces)

  1. Click Open in Codespaces above.

  2. Wait ~90 seconds for the environment to build (pip install runs automatically).

  3. Open the Chat panel on the right, set mode to Agent, click the tools icon — you should see two tools from component-workshop.

  4. Ask Copilot:

    who owns component CM101A?

    Copilot picks lookup_component, calls it, and answers.

That's the whole loop. The workshop tasks are edits to it — see HANDS_ON.md.

What's here

  • server.py — the MCP server, two working tools
  • .vscode/mcp.json — registers the server with Copilot Chat's Agent mode
  • data/ — synthetic components and NTCs
  • client.py — optional stdio client, prints raw wire messages (no AI)
  • HANDS_ON.md — the two workshop tasks
  • CHEAT_SHEET.md — restarts, common errors, troubleshooting
  • SOLUTION.md — peek only if Copilot stalls

The mental model

An MCP server is a toolbox with labeled drawers. Each tool is a drawer. The tool's description string is the label taped on it. The AI reads the labels to decide which drawer to open.

Your job as a tool author: write labels the AI can act on.

What you will build

See HANDS_ON.md.

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured