MCP server/other

MCP Demo MCP Server

A simple MCP server with a web-based configuration interface.

tanteng/mcp-demo ↗by tantengupdated
Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

npm install
npm run start:config
npm run start
2

Register it in Claude Code

claude mcp add mcp-demo -- node /path/to/mcp-demo/src/index.js

Replace any placeholder paths in the command with the real path on your machine.

3

Make your agent remember this setup

mcp-demo's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

  • Web-based configuration interface at localhost:3001
  • Persistent configuration storage
  • Personalized greeting tool with placeholder support
  • Echo functionality for testing input
  • Tool-based configuration management

Tools 5

greetGet a personalized greeting
echoEcho back input text
get_configView current configuration
update_configUpdate configuration via MCP
list_itemsList demo items

Try it

Can you greet me using the MCP Demo server?
Echo back the phrase 'Hello Model Context Protocol'.
What is the current configuration of the MCP Demo server?
List the available demo items.
Original README from tanteng/mcp-demo

MCP Demo

A simple MCP (Model Context Protocol) server with a web-based configuration interface.

Features

  • MCP server with 5 tools: greet, echo, get_config, update_config, list_items
  • Web-based config UI at http://localhost:3001
  • Persistent configuration storage

Quick Start

# Install dependencies
npm install

# Start the web config server
npm run start:config

# In another terminal, start the MCP server (for testing)
npm run start

Configuration

Open http://localhost:3001 in your browser to configure:

  • Enable MCP Server: Toggle MCP functionality
  • Greeting Message: Customize the greet message (use {name} placeholder)
  • Max Results: Limit list_items output

MCP Tools

Tool Description
greet Get a personalized greeting
echo Echo back input text
get_config View current configuration
update_config Update configuration via MCP
list_items List demo items

Usage with OpenClaw

Add to your config:

{
  "mcpServers": {
    "mcp-demo": {
      "command": "node",
      "args": ["/path/to/mcp-demo/src/index.js"]
    }
  }
}

License

MIT

Frequently Asked Questions

What are the key features of MCP Demo?

Web-based configuration interface at localhost:3001. Persistent configuration storage. Personalized greeting tool with placeholder support. Echo functionality for testing input. Tool-based configuration management.

What can I use MCP Demo for?

Testing and validating MCP server connectivity. Learning how to implement persistent configuration in MCP servers. Demonstrating web-based UI integration with MCP tools. Experimenting with basic tool execution and parameter handling.

How do I install MCP Demo?

Install MCP Demo by running: npm install && npm run start:config && npm run start

What MCP clients work with MCP Demo?

MCP Demo works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep MCP Demo docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest