https://github.com/non-npc/vibe-model-context-protocol-server
A Python-based server for managing and analyzing code context for AI-assisted development, without the monthly costs of a subscription API.
https://github.com/non-npc/vibe-model-context-protocol-server
ai chatgpt claude mcp python server vibe
Last synced: 6 months ago
JSON representation
A Python-based server for managing and analyzing code context for AI-assisted development, without the monthly costs of a subscription API.
- Host: GitHub
- URL: https://github.com/non-npc/vibe-model-context-protocol-server
- Owner: non-npc
- License: mit
- Created: 2025-04-02T17:02:12.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-02T17:46:31.000Z (6 months ago)
- Last Synced: 2025-04-09T15:15:07.979Z (6 months ago)
- Topics: ai, chatgpt, claude, mcp, python, server, vibe
- Language: Python
- Homepage:
- Size: 55.7 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
this is a WIP (work in progress)
# 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:
```bash
git clone https://github.com/non-npc/Vibe-Model-Context-Protocol-Server.git
cd mcps
```
2. Create a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
3. Install dependencies:
```bash
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:
```bash
python -m mcps.main
```
1. Get token:
```bash
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):
```bash
curl -X POST "http://localhost:8000/analyze" -H "Authorization: Bearer " -H "Content-Type: application/json" -d '{"project_path": "/path/to/your/project"}'
```
3. Get context:
```bash
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:
```bash
pip install -r requirements-dev.txt
```
2. Run tests:
```bash
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)