Bookstore Server

Full-stack bookstore API with dual exposure: REST endpoints for web clients and MCP (Model Context Protocol) tools for LLM agents. One service layer powers both.

Highlights

• REST API for inventory, orders, and members
• Six MCP tools (search_books, get_book, check_stock, etc.)
• React admin UI with Tool Explorer to invoke MCP tools over HTTP
• Shared service/repository layer — no duplicated business logic

Stack

Layer	Tech
Backend	Node.js, Express, MCP SDK, Zod
Frontend	React, TypeScript, Vite
Data	Local JSON catalog

Getting started

npm run install:all
npm run dev:backend    # http://localhost:8003
npm run dev:frontend   # http://localhost:5176

Docker

docker compose up --build

• App: http://localhost:8081
• API: http://localhost:8003/api/v1
• MCP: http://localhost:8003/mcp

MCP tools

Tool	Purpose
search_books	Search by title, author, genre
get_book	Book details by ID
check_stock	Availability check
get_order	Order lookup
get_member	Member profile
recommend_books	Genre-based recommendations

Example

curl -X POST http://localhost:8003/api/v1/tools/call \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_books","arguments":{"query":"design"}}'

License

MIT