INSTALL.md•1.35 kB
# Installation Guide
## Quick Start
1. **Install Python dependencies:**
```bash
pip install mcp python-magic aiofiles
```
2. **Create configuration:**
```bash
python -m file_system_mcp_server.cli_utils --create-example-config config.json
```
3. **Run the server:**
```bash
python -m file_system_mcp_server.main --config config.json
```
## Development Installation
1. **Clone and install in development mode:**
```bash
pip install -e .
pip install -e ".[dev]"
```
2. **Run tests:**
```bash
python test_core_functionality.py
pytest tests/
```
## Kiro Integration
Add to your Kiro MCP configuration:
```json
{
"mcpServers": {
"file-system-operations": {
"command": "python",
"args": ["-m", "file_system_mcp_server.main"],
"cwd": ".",
"env": {
"PYTHONPATH": "src"
},
"disabled": false,
"autoApprove": [
"read_file",
"get_file_info",
"list_directory"
]
}
}
}
```
## System Dependencies
### macOS
```bash
brew install libmagic
```
### Ubuntu/Debian
```bash
sudo apt-get install libmagic1
```
### Windows
```bash
pip install python-magic-bin
```
## Verification
Run the test script to verify installation:
```bash
python test_core_functionality.py
```
You should see all tests pass with ✅ marks.