Vibe-Model-Context-Protocol-Server

Vibe-Model-Context-Protocol-Server

11
developer_tools

Vibe Model Context Protocol Server (VMCPS) is a Python server designed to manage and analyze code context for AI-enhanced development. It features real-time code analysis, secure authentication, a RESTful API, and cross-platform support.

Vibe Model Context Protocol Server (VMCPS)

A Python-based server for managing and analyzing code context for AI-assisted development. Vibe Model Context Protocol Server Screenshot

Features

  • Real-time code analysis and context generation
  • Automatic file change detection
  • Secure authentication and authorization
  • RESTful API for context management
  • Project structure analysis
  • Dependency tracking
  • Cross-platform support (Windows, Linux, macOS)

API Endpoints

  • POST /token - Get authentication token
  • POST /analyze - Analyze a project
  • GET /context - Get context for a file or project
  • GET /dependencies - Get project dependencies
  • GET /structure - Get project structure

Security

  • JWT-based authentication
  • Password hashing with bcrypt
  • CORS protection
  • Environment-based configuration

Installation

  1. Clone the repository:
git clone https://github.com/non-npc/Vibe-Model-Context-Protocol-Server.git
cd mcps
  1. Create a virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Configure environment variables:
  • Copy .env.example to .env
  • Update the values in .env as needed

Example API Usage (curl commands)

Start the server:

python -m mcps.main
  1. Get token:
curl -X POST "http://localhost:8000/token" -H "Content-Type: application/x-www-form-urlencoded" -d "username=admin&password=admin"
  1. Analyze project (replace with actual token):
curl -X POST "http://localhost:8000/analyze" -H "Authorization: Bearer <token>" -H "Content-Type: application/json" -d '{"project_path": "/path/to/your/project"}'
  1. Get context:
curl -X GET "http://localhost:8000/context" -H "Authorization: Bearer <token>"

Access the API:

  • The server will be running at http://localhost:8000
  • API documentation is available at http://localhost:8000/docs

Development

  1. Install development dependencies:
pip install -r requirements-dev.txt
  1. Run tests:
pytest

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

License