sample-mcp-server MCP Server

What is sample-mcp-server?

sample-mcp-server is a TypeScript-based MCP (Model Context Protocol) server that implements a simple notes system. It demonstrates core MCP concepts by providing resources (text notes with URIs and metadata), tools (creating new notes), and prompts (generating summaries of notes). It is intended for use with MCP clients like Claude Desktop.

How to use sample-mcp-server?

Install dependencies with npm install, then build the server with npm run build. To use with Claude Desktop, add a server configuration entry in claude_desktop_config.json (on MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows: %APPDATA%/Claude/claude_desktop_config.json) pointing the command to the built build/index.js file. For debugging, run npm run inspector to start the MCP Inspector.

Key features of sample-mcp-server

• List and access text notes via note:// URIs
• Each note has a title, content, and metadata
• Plain text mime type for simple content access
• create_note tool for creating new notes with title and content
• summarize_notes prompt that returns all notes as embedded resources
• Stores notes in server state

Use cases of sample-mcp-server

• Create and manage text notes through an MCP client
• Generate structured summaries of all stored notes for LLM consumption
• Learn and demonstrate MCP server development patterns

FAQ from sample-mcp-server

What does sample-mcp-server do?

It implements a simple notes system as a Model Context Protocol server, providing resources, tools, and prompts for note creation, retrieval, and summarization.

How do I install sample-mcp-server for Claude Desktop?

Add the server configuration to your Claude Desktop config file with the command pointing to the built build/index.js. The exact file location depends on your operating system.

How do I debug sample-mcp-server?

Use the MCP Inspector by running npm run inspector in the server directory. This provides a URL for accessing debugging tools in your browser.

What are the dependencies for sample-mcp-server?

The server requires Node.js and npm to install dependencies (npm install) and build the TypeScript source (npm run build). It communicates over stdio.

Where are notes stored in sample-mcp-server?

Notes are stored in the server’s state, which is volatile and not persisted across restarts.