Rethunk-Tech/mcp-template-node
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
Create Note
Create new notes with titles and content
List Notes
List all available notes with their IDs and titles
Get Note
Retrieve specific notes by ID
Update Note
Update the title, content, or label of an existing note
Delete Note
Delete notes by ID
