mcp-dev-server MCP Server

What is mcp-dev-server?

mcp-dev-server is a TypeScript-based MCP (Model Context Protocol) server that implements a simple notes system. It demonstrates core MCP concepts by providing resources, tools, and prompts, and is intended for developers learning or testing MCP capabilities.

How to use mcp-dev-server?

Install dependencies with npm install, build with npm run build, and for auto-rebuild use npm run watch. To use with Claude Desktop, add a server configuration JSON pointing to the built index.js file.

Key features of mcp-dev-server

• Provides resources that list and access text notes via note:// URIs
• Includes a create_note tool for creating new notes
• Offers a summarize_notes prompt to generate LLM summaries
• Uses plain text mime type for simple content access
• Each note has a title, content, and metadata
• All notes are stored in server state

Use cases of mcp-dev-server

• Learning how MCP resources, tools, and prompts work in practice
• Building a simple, in-memory note-taking system controlled via MCP
• Demonstrating structured prompt generation for large language models
• Testing and debugging MCP server implementations

FAQ from mcp-dev-server

What dependencies are required to run mcp-dev-server?

Node.js and npm are required to install dependencies and build the server.

How does mcp-dev-server communicate with clients?

It uses stdio as the transport protocol, as is standard for MCP servers.

Where are notes stored and are they persisted?

Notes are stored in server state (in memory) and are not persisted to disk.

How can I debug mcp-dev-server?

Use the MCP Inspector, available via the npm run inspector command, which provides a URL for debugging tools.