NexusMCP Client (CLI)

A minimal TypeScript CLI agent that connects to the Junction Engine MCP server over Streamable HTTP and uses an OpenAI model for tool selection + answer synthesis.

Prereqs

• bun
• Engine running locally with MCP endpoint at http://localhost:3000/mcp

Setup

cp .env.example .env
bun install

In .env, set:

• MCP_BASE_URL=http://localhost:3000/mcp
• OPENAI_API_KEY=...
• OPENAI_MODEL=gpt-5-mini (or your preferred model)

Commands

List tools

bun run list-tools

Call a tool

bun run dev -- --call search_courses '{"department":"COS","term":1262}'

Start chat loop

bun run chat

Notes

• The client maintains a single mcp-session-id for the lifetime of the process.
• Tool calls are allowlisted to the MVP tool surface defined in the project plan.md.