# Nyx Nvim

> Neovim config + MCP Python bridge — a code editor built for AI agents

- **Type:** MCP server
- **Install:** `agentstack add mcp-adithyaa71-nyx-nvim`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Adithyaa71](https://agentstack.voostack.com/s/adithyaa71)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Adithyaa71](https://github.com/Adithyaa71)
- **Source:** https://github.com/Adithyaa71/nyx-nvim

## Install

```sh
agentstack add mcp-adithyaa71-nyx-nvim
```

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

## About

# Nyx-Nvim

[](https://opensource.org/licenses/MIT)
[](https://neovim.io/)
[](https://www.python.org/)

> *"Ship it. Don't overthink — write code, test it, iterate."*  
> — The Nyx-Agent Philosophy (for Neovim)

## 🚀 Overview

**Nyx-Nvim** is a comprehensive Neovim configuration and MCP (Model Context Protocol) abstraction layer designed to create a powerful AI-assisted development environment. This repository contains the complete implementation for a production-ready Neovim setup with full MCP integration.

## 🏗️ Architecture

```
    ┌─────────────────────────────────────────────────────────────────────┐
    │                        Model Context Protocol (MCP)                 │
    └─────────────┬───────────────────────────────────────────────────────┘
                  │
    ┌─────────────▼─────────────┐          ┌──────────────────────────┐
    │    Nyx-Nvim Configuration   │◄─────────┤     AI Coding Agent      │
    │        (Neovim)             │          │   (MCP Client)           │
    └─────────┬───▲─────────────┘          └──────────────┬───────────┘
              │   │                              │
    ┌─────────▼───▼─────────────┐  ┌─────────────▼───────────────┐
    │   Neovim + Plugins        │  │  LLM Backends & Models      │
    │  (MCP Server + Tools)     │  │  (Qwen, LLaMA, Claude, etc.)│
    └─────────────┬─────────────┘  └─────────────────────────────┘
                  │
    ┌─────────────▼─────────────┐
    │     MCP Tools Layer         │
    │  (Python for Neovim)       │
    └─────────────────────────────┘
 ```

## 🌟 Features

- **Full MCP Integration**: Native Model Context Protocol implementation for AI-powered development
- **Modern Neovim Setup**: Professional configuration with productivity-enhancing plugins
- **MCP Abstraction Layer**: Python tools for seamless Neovim-AI communication
- **Code Analysis Tools**: Advanced refactoring, search, and analysis capabilities
- **Git Integration**: Seamless repository management within Neovim
- **Language Server Protocol**: Full LSP support for multiple languages 

## 📦 Prerequisites

- **Neovim 0.9+** (latest stable recommended)
- **Python 3.11+** (for MCP tools)
- **Node.js 18+** (MCP server)
- **Git 2.0+**

## 🛠️ Installation

1. **Clone the repository**:
   ```bash
   git clone https://github.com/Adithyaa71/nyx-nvim.git
   cd nyx-nvim
   ```

2. **Setup Neovim**:
   ```bash
   # Install Python dependencies
   pip install -r requirements.txt
   
   # Install Node.js packages for MCP
   npm install -g mcp-neovim-server
   ```

3. **Install Neovim plugins**:
   ```bash
   # Using lazy.nvim (recommended)
   nvim +LazySync +qall
   ```

## 🚀 Quick Start

1. **Launch Neovim**:
   ```bash
   nvim
   ```

2. **Verify MCP Integration**:
   ```vim
   :MCPStatus
   ```

3. **Start AI Coding Session**:
   ```vim
   :NyxStart
   ```

## 📁 Directory Structure

```
nyx-nvim/
├── nvim/              # Neovim configuration
│   ├── init.lua       # Main configuration
│   └── lua/           # Lua modules
│       ├── core/      # Core configuration
│       ├── plugins/   # Plugin definitions
│       └── util/      # Utility modules  
├── mcp/               # MCP protocol implementation
│   ├── mcp_client.py   # Client for AI agent communication  
│   └── get_nvim_socket.sh # Socket connection helper
├── tools/             # Utility tools for development
│   ├── analysis.py     # Code analysis tools
│   ├── refactor.py     # Refactoring tools  
│   ├── search.py       # Code search tools
│   └── internal/       # Internal tools
│       ├── _lsp.py     # LSP integration
│       ├── _treesitter.py # Tree-sitter integration
│       ├── _git.py     # Git tools
│       └── _telescope.py # Telescope search
├── skills/            # Agent skills
│   └── summarize_file.py # File analysis skill
├── README.md          # This file
├── INSTALL.md         # Installation guide
└── .gitignore         # Git ignore rules
```

## 🔧 Configuration

Nyx-Nvim uses a modular configuration approach:

1. **Main Configuration**: `nvim/init.lua`
2. **Plugin Settings**: `nvim/lua/plugins/`
3. **Core Settings**: `nvim/lua/core/` 
4. **Utility Modules**: `nvim/lua/util/`

## 📚 Documentation

- **INSTALL.md** - Complete installation guide
- **nvim/lua/README.md** - Neovim configuration documentation

## 🤝 Contributing

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

## 📄 License

MIT License - see [LICENSE](LICENSE) for details.

## 📬 Contact

Questions or issues? Open a [GitHub issue](https://github.com/Adithyaa71/nyx-nvim/issues) or reach out via [GitHub](https://github.com/Adithyaa71).

---

*Powered by AI-enabled development tools*

## Source & license

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

- **Author:** [Adithyaa71](https://github.com/Adithyaa71)
- **Source:** [Adithyaa71/nyx-nvim](https://github.com/Adithyaa71/nyx-nvim)
- **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:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **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-adithyaa71-nyx-nvim
- Seller: https://agentstack.voostack.com/s/adithyaa71
- 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%.