MCP Hausaufgabe — Host, zwei Transporte und eine Fertigkeit

Dieses Projekt erfüllt die lokalen Teile der Aufgabe ohne zusätzliche Frameworks:

• ein CLI-Agent mit Ollama qwen3.5:4b;

• ein MCP-Host, der Konfiguration lädt, Tools zusammenführt und Aufrufe weiterleitet;

• ein stdio-Todo-Server mit 3 Tools, 1 Resource und 1 Prompt;

• derselbe Server über authentifiziertes lokales Streamable HTTP;

• progressives Laden von Fertigkeiten mittels use_skill;

• Persistenz, Validierung, behebbare MCP-Fehler und Integrationstests.

Öffentliches Hosting wird bewusst nicht durchgeführt. Siehe PUBLIC_HTTP.md für die genauen Bereitstellungsschritte.

Voraussetzungen

• Node.js 20+

• Ollama

• qwen3.5:4b: ollama pull qwen3.5:4b

Related MCP server: Personal OS MCP

Installieren und verifizieren

npm install
npm test
npm run check

Alles lokal ausführen

Verwenden Sie in beiden Terminals denselben lokalen Schlüssel. Er wird nicht eingecheckt.

Terminal 1 — starten Sie den authentifizierten HTTP-Server:

export MCP_KEY="$(openssl rand -hex 32)"
echo "$MCP_KEY"   # copy this value for terminal 2
npm run server:http

Terminal 2 — stellen Sie sicher, dass Ollama läuft, dann starten Sie den Agenten:

export MCP_KEY="paste-the-same-value"
ollama serve      # omit if Ollama is already running

Führen Sie in einem anderen Terminal aus:

export MCP_KEY="paste-the-same-value"
npm run agent

Probieren Sie diese Anfragen aus:

Add "finish MCP homework" using the stdio todo server.
Add "record the demo" using the HTTP todo server.
Standup time — what should I work on today?

Die letzte Anfrage sollte use_skill("daily-plan") auslösen, dann beide MCP-Server aufrufen und Heute, Später und Blockierer zurückgeben.

Mit MCP Inspector testen

Stdio:

npx @modelcontextprotocol/inspector node src/servers/stdio.js

HTTP:

export MCP_KEY="a-local-test-key"
npm run server:http
npx @modelcontextprotocol/inspector

Wählen Sie im Inspector Streamable HTTP, verwenden Sie http://127.0.0.1:3000/mcp, und fügen Sie den Header Authorization: Bearer a-local-test-key hinzu. Überprüfen Sie:

1. add_task, list_tasks und complete_task werden aufgelistet und sind aufrufbar.

2. todo://list kann gelesen werden.

3. plan_my_day kann geladen werden.

4. Das Abschließen einer unbekannten ID gibt isError: true zurück.

Projektübersicht

config.json                 agent/model/server configuration
skills/daily-plan/SKILL.md on-demand workflow
src/agent/                  MCP host, Ollama loop, and skill loader
src/todo/                   shared todo domain and MCP capabilities
src/servers/stdio.js        stdio entry point
src/servers/http.js         Streamable HTTP entry point
test/                       unit and protocol integration tests

Bewertungsnachweise

Demo und Checkliste zur Einreichung

Für eine kurze YouTube-Demo:

1. Zeigen Sie, dass npm test bestanden wird.

2. Zeigen Sie den stdio-Server im Inspector: Tools, Resource und Prompt.

3. Zeigen Sie, dass der HTTP-Server 401 ohne den Schlüssel zurückgibt, dann die Verbindung damit.

4. Fügen Sie im Agenten über jeden Server eine Aufgabe hinzu.

5. Fragen Sie "Standup time" und zeigen Sie das automatische Laden der Fertigkeit sowie Aufrufe beider Server.

6. Öffnen Sie kurz config.json und SKILL.md und erklären Sie das Routing.

Reichen Sie den YouTube-Link und den Quellcode auf Moodle ein. Falls Sie später bereitstellen, reichen Sie auch die öffentliche /mcp-URL und einen temporären Prüferschlüssel ein.