Vibe Model Context Protocol Server

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

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

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

[MIT License](LICENSE)

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: non-npc
• Source: non-npc/Vibe-Model-Context-Protocol-Server
• License: MIT

Install and usage instructions live in the source repository linked above.