Bookstore MCP 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

Related MCP server: Swagger MCP Adapter

Stack

Getting started

npm run install:all
npm run dev:backend    # http://localhost:3000
npm run dev:frontend   # http://localhost:5173

Docker

docker compose up --build

• App: http://localhost:8080

• API: http://localhost:3000/api/v1

• MCP: http://localhost:3000/mcp

MCP tools

Example

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

License

MIT