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