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
   

3. 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.

4. Build the project:

   npm run build
   

5. 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