Advertise
MCP.so
Sign In

sample-mcp-server MCP Server

@wudongjie

Repository

Basic information

Category

Other

Transports

stdio

Author

wudongjie

About sample-mcp-server MCP Server

An MCP server for testing

#mcp-server#typescript#notes-system

sample-mcp-server MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

sample-mcp-server MCP Server tools

1

Create new text notes

Overview

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

Where are notes stored in sample-mcp-server?

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

Comments

More Other MCP servers

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K
Advertise