MCP Demo App

What is MCP Demo App?

MCP Demo App is a Node.js/Express API server with TypeScript for managing products and orders. It integrates a Model Context Protocol (MCP) server that exposes tools for product and order queries. It uses JSON files for data storage and requires Bearer token authentication.

How to use MCP Demo App?

Install dependencies with npm install, then build using npm run build. Run the REST API server with npm run dev (development) or npm start (production). Run the MCP server separately with npm run mcp. All API endpoints except /health require a valid Bearer token in the Authorization header.

Key features of MCP Demo App

• RESTful API for products and orders
• Bearer token authentication
• Data stored in JSON files
• MCP server with four query tools
• TypeScript for type safety

Use cases of MCP Demo App

• Manage product catalog and order records via a simple REST API
• Query product details and related orders using MCP tools
• Filter orders by customer ID
• Search products by name or category

FAQ from MCP Demo App

What runtimes or dependencies are required?

Node.js v16 or later and npm are required. The server is built with Express and TypeScript.

How is data stored and where?

Data is persisted in JSON files located in src/data/. Products are in products.json and orders in orders.json.

What tools does the MCP server expose?

The MCP server provides four tools: getProductInfo, listProducts, getProductOrders, and searchProducts.

What tokens are valid for authentication?

Example valid tokens are valid_token_123 and client_abc_token. Tokens are sent in the Authorization header as Bearer <token>.

Are there any known limits?

The README does not mention specific limits such as request rate, file size, or concurrency.