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

1. Clone the repository
2. Install dependencies:

   npm install

   

   cp .env.example .env
   

Then edit the file to add your Gemini API key and other configuration options.

4. Build the project:

   npm run build

   

   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