MCP Demo

A monorepo for experimenting with the Model Context Protocol (MCP). It exposes the MindShaker Wallet API as MCP tools through a NestJS server, plus an interactive Claude CLI client that connects to the server and calls those tools.

Project structure

MCP-demo/
├── apps/
│   ├── mcp-server/    # NestJS app — MCP server (Wallet API tools)
│   └── mcp-client/    # Interactive Claude CLI client (MCP tool support)
├── libs/
│   └── api-common/    # Shared config utilities
├── docs/              # Testing and integration guides
├── package.json
└── README.md

Related MCP server: MCP Redirect Server

Prerequisites

• Node.js 18+ (22 recommended)

• npm 9+

• A running MindShaker Wallet API (for tool calls that hit the upstream API)

Getting started

Install dependencies from the repository root:

npm install

Copy and configure environment variables:

cp apps/mcp-server/.env.template apps/mcp-server/.env

Start the MCP server:

npm run start:server:dev

When ready, the server prints:

MCP server is running on port 4000
MCP endpoint: POST http://localhost:4000/mcp/v1

Scripts

Run these from the repository root:

You can also run scripts inside a single app with the -w flag:

npm run start:dev -w @mcp-demo/mcp-server
npm run build -w @mcp-demo/mcp-client

Apps

@mcp-demo/mcp-server

A NestJS application that exposes the MindShaker Wallet API as MCP tools over HTTP.

• Port: 4000 (override with PORT)

• MCP endpoint: POST /mcp/v1 (requires x-api-key or Authorization: Bearer)

• Source: apps/mcp-server/src/

MCP tools

Tool registration lives under apps/mcp-server/src/mcp/tools/. Each category has a matching service in apps/mcp-server/src/mcp/api/.

The search_knowledge_base tool adds Retrieval-Augmented Generation (RAG) over your own documents using LlamaIndex + Voyage AI embeddings + a local LanceDB vector store. Configure VOYAGE_API_KEY, add documents under apps/mcp-server/knowledge/, then build the index with npm run ingest:knowledge -w @mcp-demo/mcp-server. See docs/rag-knowledge-base.md for full setup.

See docs/testing-mcp-endpoint.md for curl examples and docs/claude-desktop.md for Claude Desktop integration.

@mcp-demo/mcp-client

An interactive command-line chat client that talks to Claude and exposes the MCP server's tools to the model. It connects to the MCP server over streamable HTTP, discovers the available tools, and lets Claude call them automatically while you chat in the terminal.

• Source: apps/mcp-client/src/

• Transport: Streamable HTTP to the MCP server (MCP_SERVER_URL, default http://127.0.0.1:4000/mcp/v1)

Configure environment variables:

cp apps/mcp-client/.env.template apps/mcp-client/.env

With the MCP server running, start the client:

npm run start:client

Type a message and press Enter to chat. Type exit or press Ctrl+C to quit.

Workspaces

This project uses npm workspaces. Dependencies are hoisted to the root node_modules/, and each app under apps/ has its own package.json.

License

ISC