MCP Relay Mind Server

🚀 MCP Server

A middleware server that serves as a bridge between Cursor IDE and AI models, and validates AI responses using project context.

✨ Features

• Project Context Management - Manage and maintain project context information.
• AI Response Validation - Validate whether AI-generated responses meet project requirements.
• Integration with Gemini API - Integrate the Gemini API to provide powerful AI capabilities.
• Real-time Context Update - Update and synchronize project context information in real-time.
• Comprehensive Logging System - Record server operation status and operation logs.
• Easy Local Deployment - Provide a simple and easy-to-use local deployment solution.

📦 Prerequisites

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

🚀 Quick Start

1. Clone the repository:

   git clone [repository URL]
   

2. Install dependencies:

   npm install
   

3. Create a .env file and configure it based on the provided .env.example template:

   cp .env.example .env
   

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

4. Build the project:

   npm run build
   

5. Start the server:

   npm start
   

   Use hot-reloading in the development environment:

   npm run dev
   

🚀 Deployment

Local Deployment

Use the provided deployment script for one-click local deployment:

./scripts/deploy-local.sh

This script will perform the following operations:

• Check the existence of the .env file.
• Install all dependencies.
• Build the project.
• Start the server in production mode. For more detailed deployment instructions, refer to 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-generated responses.
• POST /api/cursor/validate - Validation endpoint exclusive to Cursor IDE. For more detailed information, refer to USAGE.md.

📚 Project Structure

mcp-server/
├── src/
│   ├── api/
│   │   ├── controllers/
│   │   ├── middleware/
│   │   └── routes/
│   ├── config/
│   ├── context/
│   ├── models/
│   ├── services/
│   ├── types/
│   ├── utils/
│   └── index.ts
├── logs/           # Log file 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