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

- **Type:** MCP server
- **Install:** `agentstack add mcp-non-npc-vibe-model-context-protocol-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [non-npc](https://agentstack.voostack.com/s/non-npc)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [non-npc](https://github.com/non-npc)
- **Source:** https://github.com/non-npc/Vibe-Model-Context-Protocol-Server

## Install

```sh
agentstack add mcp-non-npc-vibe-model-context-protocol-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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)

## 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](https://github.com/non-npc)
- **Source:** [non-npc/Vibe-Model-Context-Protocol-Server](https://github.com/non-npc/Vibe-Model-Context-Protocol-Server)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-non-npc-vibe-model-context-protocol-server
- Seller: https://agentstack.voostack.com/s/non-npc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
