Skip to main content
Glama

MCP Node Tasks

Dette projekt er en lille MCP-server lavet i almindelig Node.js.

Formålet er at vise de tre vigtigste MCP-primitives:

  1. Resource: AI’en kan læse data.

  2. Tool: AI’en kan udføre en handling.

  3. Prompt: AI’en kan hente en genbrugelig arbejdsgang.

Projektet bruger en lokal tasks.json-fil som eksempel.

Hvad viser projektet?

Serveren kan tre ting:

  1. Læse alle tasks som en MCP resource.

  2. Oprette en ny task som et MCP tool.

  3. Levere en prompt til task-analyse.

Det centrale er ikke selve tasklisten. Det centrale er at forstå forskellen på:

  • Resources: read-only kontekst

  • Tools: handlinger med mulig side effect

  • Prompts: genbrugelige arbejdsgange

Related MCP server: tasks-mcp

Projektstruktur

mcp-node-tasks/
├── data/
│   └── tasks.json
├── node_modules/
├── package.json
├── package-lock.json
└── server.js

Installation

Åbn terminalen i projektmappen:

cd C:\Users\mikc\WebstormProjects\mcp-node-tasks

Installer dependencies:

npm install @modelcontextprotocol/sdk zod

package.json skal indeholde "type": "module", fordi projektet bruger moderne import-syntaks i Node.js.

Eksempel på package.json:

{
  "name": "mcp-node-tasks",
  "version": "1.0.0",
  "type": "module",
  "scripts": {
    "start": "node server.js",
    "inspector": "npx @modelcontextprotocol/inspector node server.js"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "^1.0.0",
    "zod": "^4.0.0"
  }
}

Datafil

Opret mappen data og filen tasks.json.

[
  {
    "id": 1,
    "title": "Lav README til projektet",
    "status": "open",
    "priority": "high"
  },
  {
    "id": 2,
    "title": "Ryd op i routes",
    "status": "open",
    "priority": "medium"
  },
  {
    "id": 3,
    "title": "Skriv testdata",
    "status": "done",
    "priority": "low"
  }
]

Serverkode

Opret filen server.js.

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import { mkdir, readFile, writeFile } from "node:fs/promises";
import path from "node:path";

const dataDir = path.join(process.cwd(), "data");
const tasksFile = path.join(dataDir, "tasks.json");

async function readTasks() {
  try {
    const raw = await readFile(tasksFile, "utf-8");
    return JSON.parse(raw);
  } catch {
    return [];
  }
}

async function writeTasks(tasks) {
  await mkdir(dataDir, { recursive: true });
  await writeFile(tasksFile, JSON.stringify(tasks, null, 2), "utf-8");
}

const server = new McpServer({
  name: "task-mcp-node",
  version: "1.0.0"
});

/*
  Resource:
  Giver read-only adgang til alle tasks.
  Den ændrer ikke data.
*/
server.registerResource(
  "all_tasks",
  "tasks://all",
  {
    title: "Alle tasks",
    description: "Returnerer alle tasks fra den lokale tasks.json-fil.",
    mimeType: "application/json"
  },
  async (uri) => {
    const tasks = await readTasks();

    return {
      contents: [
        {
          uri: uri.href,
          mimeType: "application/json",
          text: JSON.stringify(tasks, null, 2)
        }
      ]
    };
  }
);

/*
  Tool:
  Opretter en ny task.
  Dette er en handling med side effect,
  fordi serveren ændrer tasks.json.
*/
server.registerTool(
  "add_task",
  {
    title: "Opret task",
    description: "Opretter en ny task i tasks.json.",
    inputSchema: {
      title: z.string().min(1),
      priority: z.enum(["low", "medium", "high"]).default("medium")
    },
    outputSchema: {
      id: z.number(),
      title: z.string(),
      status: z.string(),
      priority: z.string()
    }
  },
  async ({ title, priority }) => {
    const tasks = await readTasks();

    const nextId =
      tasks.length === 0
        ? 1
        : Math.max(...tasks.map((task) => task.id)) + 1;

    const newTask = {
      id: nextId,
      title,
      status: "open",
      priority
    };

    tasks.push(newTask);
    await writeTasks(tasks);

    return {
      content: [
        {
          type: "text",
          text: `Task oprettet: ${newTask.title}`
        }
      ],
      structuredContent: newTask
    };
  }
);

/*
  Prompt:
  Giver en genbrugelig arbejdsgang.
  Prompten ændrer ikke data.
  Den beskriver kun, hvordan AI’en skal arbejde.
*/
server.registerPrompt(
  "analyze_tasks",
  {
    title: "Analyser tasks",
    description: "Hjælper med at prioritere tasks ud fra status og priority.",
    argsSchema: {
      focus: z.string().optional()
    }
  },
  ({ focus }) => ({
    messages: [
      {
        role: "user",
        content: {
          type: "text",
          text:
            "Du skal analysere en taskliste fra en MCP resource. " +
            "Fokuser på åbne tasks, prioritet og næste handling. " +
            `Særligt fokus: ${focus ?? "ingen særligt fokus"}. ` +
            "Svar kort og struktureret."
        }
      }
    ]
  })
);

const transport = new StdioServerTransport();

/*
  Vigtigt:
  Ved stdio må man ikke bruge console.log(),
  fordi stdout bruges til MCP/JSON-RPC beskeder.

  Brug console.error() til logs.
*/
console.error("Starter task-mcp-node via stdio");

await server.connect(transport);

Kør serveren

Serveren kan startes med:

npm start

Det kan godt ligne, at serveren bare står stille. Det er normalt.

Ved stdio venter serveren på, at en MCP-client forbinder til den.

Stop serveren igen med:

Ctrl + C

Test med MCP Inspector

MCP Inspector bruges til at teste MCP-serveren i browseren.

Kør:

npm run inspector

Når browseren åbner, skal venstre side vise:

Transport Type: STDIO
Command: node
Arguments: server.js

Klik derefter på:

  1. Resources

  2. List Resources

  3. Prompts

  4. List Prompts

  5. Tools

  6. List Tools

Du bør kunne se:

Resource:
all_tasks

Tool:
add_task

Prompt:
analyze_tasks

Test resource

Gå til fanen Resources.

Klik på List Resources.

Vælg all_tasks.

Resource skal returnere indholdet fra data/tasks.json.

Resource er read-only. Den læser data, men ændrer ikke filen.

Test tool

Gå til fanen Tools.

Klik på List Tools.

Vælg add_task.

Kald tool’et med for eksempel:

{
  "title": "Skriv kort README",
  "priority": "high"
}

Efter kaldet bør data/tasks.json være ændret.

Dette er et tool, fordi det udfører en handling og har side effect.

Test prompt

Gå til fanen Prompts.

Klik på List Prompts.

Vælg analyze_tasks.

Kald prompten med for eksempel:

{
  "focus": "hvad skal laves først før aflevering"
}

Prompten ændrer ikke data.

Den giver en genbrugelig arbejdsinstruktion til AI’en.

Didaktisk forklaring

Dette projekt viser en vigtig MCP-pointe:

Resources giver AI’en noget at vide.
Tools får systemet til at gøre noget.
Prompts giver AI’en en arbejdsform.

I dette projekt betyder det:

tasks://all
= resource
= læser tasks.json

add_task
= tool
= skriver til tasks.json

analyze_tasks
= prompt
= giver en fast struktur til analyse

Det er vigtigt at skelne mellem læsning og handling.

En resource bør være read-only. Den giver AI’en kontekst, men ændrer ikke noget.

Et tool kan udføre en handling. Derfor skal tools designes mere forsigtigt, især hvis de kan skrive, slette, sende eller ændre data.

En prompt er ikke en handling i sig selv. Den er en genbrugelig skabelon, som hjælper AI’en med at arbejde på en bestemt måde.

Hvorfor er det smart?

Det smarte er, at funktionerne ikke bare ligger skjult i en almindelig Node.js-app.

De bliver udstillet som MCP capabilities.

Det betyder, at en MCP-host kan opdage dem:

  • Hvilke resources findes?

  • Hvilke tools findes?

  • Hvilke prompts findes?

  • Hvilke input kræver de?

  • Hvad returnerer de?

Det gør integrationen mere standardiseret end en hardcoded specialløsning.

Typiske fejl

Cannot use import statement outside a module

Årsag:

package.json mangler:

"type": "module"

Løsning:

Tilføj "type": "module" i package.json.

npm kan ikke finde package.json

Årsag:

Du står i den forkerte mappe.

Løsning:

Gå til den mappe, hvor package.json ligger.

cd C:\Users\mikc\WebstormProjects\mcp-node-tasks

Serveren virker som om den hænger

Det er normalt ved stdio.

Serveren venter på, at en MCP-client taler med den.

Brug MCP Inspector til at teste serveren.

Console.log ødelægger kommunikationen

Ved stdio bruger MCP stdout til JSON-RPC-beskeder.

Brug derfor ikke:

console.log("Server startet");

Brug i stedet:

console.error("Server startet");

Forslag til udvidelse

Tilføj et nyt tool:

complete_task

Tool’et skal tage et id som input og ændre taskens status til done.

Eksempel på input:

{
  "id": 1
}

Diskussion:

  • Hvorfor er complete_task et tool?

  • Hvad skal der ske, hvis id ikke findes?

  • Hvordan skal fejl returneres?

  • Skal brugeren godkende handlingen først?

Kort opsamling

Dette projekt viser en simpel MCP-server i Node.js.

Serveren har:

  • en resource til at læse tasks

  • et tool til at oprette tasks

  • en prompt til at analysere tasks

Det er et godt første MCP-eksempel, fordi det kobler MCP til noget kendt fra Node.js-undervisning:

  • JSON

  • fil-I/O

  • npm

  • asynkrone funktioner

  • backendlogik

  • inputvalidering

  • separation mellem læsning og handling

Available Tools

1 tool
add_taskOpret taskC

Opretter en ny task i tasks.json.

ParametersJSON Schema
NameRequiredDescriptionDefault
titleYes
priorityNomedium

Output Schema

ParametersJSON Schema
NameRequiredDescription
idYes
titleYes
statusYes
priorityYes

TDQS

C2.5/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided; description fails to disclose any behavioral traits such as idempotency, error handling, or side effects (e.g., whether it appends or overwrites tasks.json).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Single short sentence is concise but omits essential information. Could include parameter details or usage context without losing conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite having an output schema (per context signals), description does not clarify expected return values or behavior. Incomplete for a simple create tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%. Description does not mention or explain parameters, leaving the agent to rely solely on the schema, which lacks descriptions for each property.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description clearly states the tool creates a new task in tasks.json, using specific verb and resource. Without sibling tools, it's unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives. Even without siblings, context like prerequisites or suitable scenarios is missing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev1.0.0
    • First observedadd_task

TDQS

C2.7/5.0
Disambiguation5/5

Only one tool exists, so there is no ambiguity. The tool's purpose is clearly stated.

Naming Consistency5/5

The single tool uses a clear verb_noun pattern ('add_task'), consistent with best practices.

Tool Count2/5

With only one tool for a task management server, the scope is extremely limited. Task management typically requires multiple operations.

Completeness1/5

The server provides only a create operation. Missing essential operations like list, read, update, and delete tasks, making it severely incomplete.

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    C
    maintenance
    A task manager MCP server that demonstrates all three MCP primitives (tools, resources, prompts). Enables users to manage tasks, read task summaries and details, and run structured planning/review prompts through natural language.
    -
  • F
    license
    Not graded
    quality
    B
    maintenance
    A lightweight task management MCP server that enables CRUD operations on tasks stored in a single JSON file, including listing, creating, updating progress, and setting priorities.
    221
    -
  • F
    license
    B
    quality
    C
    maintenance
    A task manager MCP server that enables creating, reading, updating, and deleting tasks persisted in a local JSON file.
    4
    -

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/krollchristensen/mcp-node-tasks'

If you have feedback or need assistance with the MCP directory API, please join our Discord server