MCP Todo Server (TypeScript)

Basic MCP server that manages a to-do list stored in a local JSON file. Developed for Extraclass Work 1 (MCP) of Programming IV, UNA.

Exposed capabilities

Related MCP server: Todo MCP Server

Installation

1. Clone this repository and enter the folder:

   git clone <url-del-repo>
   cd mcp-todo-server-ts

2. Install the dependencies:

   npm install

3. Compile the TypeScript project:

   npm run build

Execution

To test the server with the official MCP Inspector (web interface where you can call the resource, tools, and prompt without needing Claude Desktop):

npm run inspector

To run it directly:

npm start

Connection with Claude Desktop

See instructions in the claude_desktop_config.json configuration section of Exercise 3 of this work. The command to register points to the compiled file, for example:

{
  "mcpServers": {
    "todo-server": {
      "command": "node",
      "args": ["C:\\ruta\\completa\\a\\mcp-todo-server-ts\\build\\server.js"]
    }
  }
}

Project structure

mcp-todo-server-ts/
├── src/
│   └── server.ts        # Servidor MCP principal (código fuente)
├── build/                # Generado por "npm run build" (no se sube a git)
├── tasks.json            # Almacenamiento de tareas
├── package.json          # Dependencias y scripts
├── tsconfig.json         # Configuración de TypeScript
└── README.md             # Este archivo

Tests performed

(Complete with screenshots of npm run inspector showing at least 3 interactions: for example, adding two tasks and completing one, plus querying the resource and the daily_summary prompt.)