MCP Server: Notes Manager (TypeScript Starter)

A simple MCP (Model Context Protocol) server that manages notes. This is the companion repository for the Gheware DevOps AI YouTube tutorial: "Build Your Own MCP Server (TypeScript)".

What You'll Learn

How to create an MCP server from scratch
Implementing TOOLs (operations AI can perform)
Implementing RESOURCEs (data AI can read)
Testing with Claude Desktop and MCP Inspector

Features

Tools (AI Operations)

Tool	Description
`add_note`	Create a new note with title, content, and tags
`list_notes`	List all notes with IDs and titles
`search_notes`	Search notes by title, content, or tags
`delete_note`	Delete a note by ID

Resources (AI Data Access)

URI	Description
`notes://list`	JSON list of all notes
`notes://note/{id}`	Individual note by ID

Quick Start

Prerequisites

Node.js 18+
npm or yarn
Claude Desktop (for testing)

Installation

# Clone the repository
git clone https://github.com/brainupgrade-in/mcp-server-typescript-starter.git
cd mcp-server-typescript-starter

# Install dependencies
npm install

# Build the project
npm run build

Test with MCP Inspector

npm run inspector

This opens a browser-based inspector to test your tools and resources.

Configure Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "notes": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server-typescript-starter/dist/index.js"]
    }
  }
}

Restart Claude Desktop after saving.

Usage Examples

Once connected to Claude Desktop, try these prompts:

"Add a note about Docker networking with tags devops and docker"

"List all my notes"

"Search for notes about devops"

"Delete the welcome note"

Project Structure

mcp-server-typescript-starter/
├── src/
│   └── index.ts        # Main MCP server code
├── dist/               # Compiled JavaScript (after build)
├── package.json        # Dependencies and scripts
├── tsconfig.json       # TypeScript configuration
└── README.md           # This file

Code Walkthrough

1. Server Setup

const server = new Server(
  { name: "notes-manager", version: "1.0.0" },
  { capabilities: { tools: {}, resources: {} } }
);

2. Defining a Tool

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: [{
    name: "add_note",
    description: "Create a new note",
    inputSchema: {
      type: "object",
      properties: {
        title: { type: "string", description: "Note title" },
        content: { type: "string", description: "Note content" }
      },
      required: ["title", "content"]
    }
  }]
}));

3. Handling Tool Calls

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;
  
  if (name === "add_note") {
    // Create the note...
    return { content: [{ type: "text", text: "Note created!" }] };
  }
});

4. Exposing Resources

server.setRequestHandler(ListResourcesRequestSchema, async () => ({
  resources: [{
    uri: "notes://list",
    name: "All Notes",
    mimeType: "application/json"
  }]
}));

Next Steps

Add persistence (save notes to a file or database)
Implement Prompts (pre-defined instruction templates)
Add authentication for multi-user support
Deploy as a standalone service

Resources

Video Tutorial

Watch the full tutorial on Gheware DevOps AI:

What is MCP?
MCP Architecture
Install Your First MCP Server
Build Your Own MCP Server ← This tutorial

License

MIT License - Feel free to use this as a starting point for your own MCP servers!

Made with ❤️ by Gheware DevOps AI

mcp-server-typescript-starter