Notes Manager
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Notes Manageradd a note about meeting notes with tags work and important"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: filesystem-mcp
Features
Tools (AI Operations)
Tool | Description |
| Create a new note with title, content, and tags |
| List all notes with IDs and titles |
| Search notes by title, content, or tags |
| Delete a note by ID |
Resources (AI Data Access)
URI | Description |
| JSON list of all notes |
| 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 buildTest with MCP Inspector
npm run inspectorThis 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 fileCode 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:
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
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Related MCP Servers
- Alicense-quality-maintenanceThis TypeScript-based MCP server enables users to manage a simple notes system with capabilities to create and summarize notes through structured prompts and resources.Last updated1
- AlicenseAqualityFmaintenanceA TypeScript-based MCP server that implements a simple notes system, allowing users to create, access, and generate summaries of text notes via URIs and tools.Last updated12318MIT
- FlicenseBqualityDmaintenanceA TypeScript-based MCP server that implements a simple notes system, providing resources for accessing notes via URIs, tools for creating notes, and prompts for generating summaries.Last updated726
- Flicense-qualityDmaintenanceA TypeScript-based MCP server that implements a simple note-taking system using low-level server components and streamable HTTP. It enables users to create, store, and summarize text notes through a set of tools, resources, and specialized prompts.Last updated3
Related MCP Connectors
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/brainupgrade-in/mcp-server-typescript-starter'
If you have feedback or need assistance with the MCP directory API, please join our Discord server