MCP Server

A middleware server that acts as a bridge between Cursor IDE and AI models, validating AI responses using project context and Gemini.

Features

Project context management
AI response validation
Integration with Gemini API
Real-time context updates
Comprehensive logging system
Easy local deployment

Prerequisites

Node.js (v14+ recommended)
npm or yarn
Google Cloud account (for Gemini API access)
Gemini API key
Cursor IDE

Getting Started

Clone the repository
Install dependencies:
```
npm install
```
Create a .env file in the root directory based on the provided .env.example:
```
cp .env.example .env
```
Then edit the file to add your Gemini API key and other configuration options.
Build the project:
```
npm run build
```
Start the server:
```
npm start
```
For development with hot-reloading:
```
npm run dev
```

Deployment

Local Deployment

Use the provided deployment script for a streamlined setup:

./scripts/deploy-local.sh

This script will:

Check for the presence of a .env file
Install dependencies
Build the project
Start the server in production mode

For more detailed deployment instructions, see USAGE.md.

API Endpoints

GET /api/health - Health check endpoint
POST /api/context/initialize - Initialize project context
POST /api/context/refresh - Refresh project context
POST /api/validate - Validate AI responses
POST /api/cursor/validate - Cursor IDE-specific validation endpoint

For detailed API documentation, see USAGE.md.

Project Structure

mcp-server/
├── src/
│   ├── api/
│   │   ├── controllers/
│   │   ├── middleware/
│   │   └── routes/
│   ├── config/
│   ├── context/
│   ├── models/
│   ├── services/
│   ├── types/
│   ├── utils/
│   └── index.ts
├── logs/           # Log files directory
├── scripts/        # Deployment and utility scripts
├── docs/           # Documentation
├── .env
├── .env.example
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

Documentation

USAGE.md - Detailed usage instructions
MCP_SERVER_IMPLEMENTATION_PLAN.md - Implementation plan
MCP_SERVER_ARCHITECTURE.md - Architecture overview

License

ISC