Vibe Model Context Protocol Server (VMCPS)

A Python-based server for managing and analyzing code context for AI-assisted development.

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

2. Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. Install dependencies:

pip install -r requirements.txt

4. 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"

2. 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"}'

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

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

MIT License