# 🛠 Developer Toolbox MCP

A production-ready MCP (Model Context Protocol) server exposing useful developer tools through a simple CLI client.

## Features

### 📂 File Tools

- List Files
- Read File
- Write File
- Append File
- Create Directory
- Delete File
- Rename File

### 🖥 System Tools

- Current Directory
- Current Time
- System Information
- Disk Usage

### 🧮 Math Tools

- Add
- Subtract
- Multiply
- Divide
- Percentage
- Factorial
- Average

### 📝 Text Tools

- Word Count
- Line Count
- Find Text
- Replace Text

---

## Project Structure

```
developer-toolbox-mcp/
│
├── server.py
├── client.py
├── requirements.txt
├── README.md
│
└── tools/
    ├── file_tools.py
    ├── system_tools.py
    ├── math_tools.py
    └── text_tools.py
```

---

## Installation

```bash
git clone <repo-url>

cd developer-toolbox-mcp

python -m venv venv

source venv/bin/activate

pip install -r requirements.txt
```

---

## Run

Start the client.

```bash
python client.py
```

The client automatically starts the MCP server.

---

## Technologies

- Python 3
- MCP Python SDK
- AsyncIO
- FastMCP

---

## Future Improvements

- OpenAI Integration
- Claude Desktop Integration
- GitHub Tools
- Weather API
- SQLite Tools
- PDF Reader
- CSV Analyzer