CompCode Academy

Lesson 48 of 65 · Free to read

Day 48 ΓÇö Building a simple custom MCP server.

Month 3 · Week 10 — MCP & Extending the AI Dev Environment Audience: Final-year students & early-career engineers (0–3 years) Format: Self-paced study + optional live clinic · Suggested time: 4–6 focused hours Key tools: Node / Python MCP SDK

Overview

Build a minimal custom MCP server exposing one tool — e.g., your app’s API — and call it from an agent.

Learning objectives

By the end of this session, you can:

  • Explain the core ideas behind: Building a simple custom MCP server.
  • Apply the ideas using Node / Python MCP SDK on a realistic task (capstone, internship, or first-job style)
  • Produce the exercise deliverable with clear success criteria
  • Identify common failure modes and how to recover
  • Capture at least one reusable prompt, rule, or checklist for your personal library
  • Decide what must remain human-reviewed for this class of work

Core concepts

Minimal server

One tool, clear JSON schema, auth to your API, structured errors.

SDK choice

Official Node/Python MCP SDKs; keep the server tiny and auditable.

Tooling for today

Primary tools: Node / Python MCP SDK. Prefer official docs when APIs change. When a model invents a symbol, verify against source or docs immediately.

Practice posture

You are a final-year or early-career engineer pairing with a very fast teammate (the model): clear intent, grounded context, inspect consequential changes, keep a paper trail (commits, prompts, decisions).

Process diagram

Watch & learn

Study these free videos before or during the exercise. Each embed is chosen to reinforce today's objectives.

Course video

Open on YouTube
Building Agents with MCP — Anthropic Workshop — Agents + tools with the protocol.

Course video

Open on YouTube
The Model Context Protocol (MCP) — Anthropic — Official walkthrough of MCP primitives.

Worked example / case study

Scenario

Implement one-tool MCP server; invoke from agent; log the call.

Step-by-step

  1. Clarify the outcome in one sentence tied to the exercise below.
  2. Gather grounding context (files, docs, schema, acceptance checks).
  3. Run the primary tool(s): Node / Python MCP SDK.
  4. Produce the smallest vertical slice that proves the idea.
  5. Verify with a command, test, screenshot, or side-by-side comparison.
  6. Write down one steering note — what you told the AI when it went wrong.

Sample prompt you can adapt

Role: Senior engineer mentoring an early-career developer (pairing with me).
Task: Building a simple custom MCP server.
Context: Final-year / early-career project (capstone, internship, or junior role).
Constraints:
- Match existing project patterns
- No new dependencies unless justified
- Include tests or a verification checklist
- Call out assumptions explicitly
Output: step plan first, then code/files, then verification commands.

Hands-on exercise

Primary task. Build a minimal MCP server exposing one tool (e.g., your app’s API) and call it from the agent.

Coaching notes

Add a second read-only tool if time permits.

Steps

  1. Set up or open the workspace required by: Node / Python MCP SDK.
  2. Skim today's core concepts and watch the video(s) before prompting.
  3. Execute the task in small commits (or saved artifacts if no-code).
  4. Fill the success checklist below.
  5. Note one surprise and one process improvement for tomorrow.

Success criteria

  • Deliverable matches the exercise description
  • You can explain every AI-generated change in plain language
  • Verification ran (tests, manual check, or published URL)
  • At least one pitfall from this lesson was consciously avoided
  • Artifact saved (repo commit, doc, or published link)

Timebox

Suggested: 90–150 minutes of focused build time after study.

Templates & checklists

AssetPurpose
Prompt stubReuse today's structure (role → task → constraints → format)
Verification checklistTests / manual QA / security skim
Decision logWhat you delegated vs kept human

Copy-paste prompt skeleton

## Goal
Building a simple custom MCP server.

## Context files
- (list paths)

## Constraints
- Stack: (fill)
- Do not: (secrets, drive-by refactors)

## Definition of done
- Build a minimal MCP server exposing one tool (e.g., your app’s API) and call it from the agent.

Daily reflection (3 minutes)

  • What did AI do well?
  • Where did it confidently fail?
  • What rule will you add to your cookbook/rules file?

Common pitfalls

  • God-object servers with 30 tools on day one
  • Returning unstructured blobs
  • Hardcoding secrets in the server

Key takeaways

  • Small servers are reviewable
  • Schemas are contracts
  • One solid tool beats ten flaky ones
  • Tools (Node / Python MCP SDK) change; the judgment skills transfer.

Resources

  • Official docs for: Node / Python MCP SDK
  • Course cookbook: keep prompts in a versioned Markdown file in your repo
  • Prior days this week — skim objectives if you skipped ahead

Self-paced lesson — Mastering AI-Assisted Development & Vibe Coding — Day 48 of 65.

New free lessons and course updates. Unsubscribe from any email.