EMR-mcp-ai-assistant

Broker

Description

Broker is a Node.js backend service that acts as a client to an MCP (Model Context Protocol) server. It provides an intelligent assistant interface for energy modeling queries by leveraging OpenAI's GPT-4o-mini model and the @modelcontextprotocol/sdk. The service exposes a REST API endpoint to process user queries related to energy system inputs and generate meaningful visualizations and analyses.

---

Features

• Connects to an MCP server script to process energy modeling queries.
• Uses OpenAI API for intelligent query processing.
• Provides a POST /query endpoint to accept and respond to user queries.
• Supports conversation reset and tool-based query processing.
• Built with Express, CORS, and dotenv for easy configuration and deployment.

---

Getting Started

Follow these steps to get the Broker service up and running on your local machine:

1. Clone the repository or copy the broker directory:

   git clone https://your-repo-url
   cd broker
   

2. Install dependencies:

   npm install
   

3. Create a .env file in the broker directory and add your OpenAI API key:

   OPENAI_API_KEY=your_openai_api_key_here
   

4. Start the server:

   node index.js
   

5. The server will start on port 3100 by default.

---

API Usage

POST /query

Accepts a JSON body with the following structure:

{
  "query": "your query string",
  "data": {
    /* optional additional structured data */
  }
}

Returns a JSON response with the processed result:

{
  "response": "response text or JSON string"
}

Example using curl:

curl -X POST http://localhost:3100/query \
  -H "Content-Type: application/json" \
  -d '{"query": "Show me energy consumption trends"}'

---

Project Structure

broker/
├── mcp/                  # MCP client scripts and utilities
│   ├── mcp-client.js
│   └── mcp-tool.js
├── SampleReq.json        # Sample request JSON for testing
├── index.js              # Main entry point for the Broker service
├── package.json          # NPM package configuration
├── README.md             # This README file
└── .env                  # Environment variables (not committed)

---

Dependencies

• express
• cors
• dotenv
• openai
• @modelcontextprotocol/sdk

---

Environment Variables

• OPENAI_API_KEY: Your OpenAI API key for accessing the GPT model.

---

Support

If you encounter any issues or have questions, please open an issue in the repository or contact the maintainers.

---