MCP Demo MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
npm install
npm run start:config
npm run start
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add mcp-demo -- node "<FULL_PATH_TO_MCP_DEMO>/dist/index.js"

Replace <FULL_PATH_TO_MCP_DEMO>/dist/index.js with the actual folder you prepared in step 1.

README.md

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

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

Tools (5)

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

Configuration

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

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.

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.

Turn this server into reusable context

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

Need the old visual installer? Open Conare IDE.
Open Conare