mcp-template-node

Rethunk-Tech/mcp-template-node

3.1

If you are the rightful owner of mcp-template-node and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A template repository for creating Model Context Protocol (MCP) servers in Node.js/TypeScript, demonstrating a simple notes management system using the MCP protocol.

The MCP Template Node is a foundational repository designed to facilitate the creation of Model Context Protocol (MCP) servers using Node.js and TypeScript. It provides a structured approach to implementing MCP, which is a standardized protocol for providing context to Large Language Models (LLMs). This template includes a simple notes management system that showcases basic CRUD operations, serving as a practical example of MCP concepts such as Tools, Resources, and Prompts. The project is built with TypeScript, ensuring strict type checking, and includes comprehensive error handling, validation, and unit tests using Vitest. Additionally, it offers in-memory storage for notes, a GitHub Actions CI workflow for testing and building, and a VS Code debugging configuration. The template is designed to be easily extendable, allowing developers to add new types, tools, resources, and prompt templates as needed.

Features

  • TypeScript implementation with strict type checking
  • Simple notes management system with basic CRUD operations
  • Comprehensive error handling and validation
  • Unit tests with Vitest
  • GitHub Actions CI workflow for testing and building

Usages

usage with local development

{
  "mcp": {
    "servers": {
      "notes-management": {
        "command": "node",
        "args": [
          "build/index.js"
        ]
      }
    }
  }
}

usage with vscode

{
  "mcp": {
    "servers": {
      "notes-management": {
        "command": "yarn",
        "args": [
          "start"
        ]
      }
    }
  }
}

usage with docker

{
  "mcp": {
    "servers": {
      "notes-management": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "mcp/notes-management"
        ]
      }
    }
  }
}

Tools

  1. Create Note

    Create new notes with titles and content

  2. List Notes

    List all available notes with their IDs and titles

  3. Get Note

    Retrieve specific notes by ID

  4. Update Note

    Update the title, content, or label of an existing note

  5. Delete Note

    Delete notes by ID