# SMB AI Command Platform - MCP Server

Model Context Protocol (MCP) server for the SMB AI Command Platform, enabling AI assistants to interact with platform APIs.

## Overview

This MCP server provides tools for AI assistants (like Claude) to:
- Query business data
- Create and manage tasks
- Access connector data
- Interact with dashboards
- Monitor security status

## Installation

```bash
npm install
npm run build
```

## Configuration

Create a `.env` file based on `.env.example`:

```env
SMB_API_URL=http://localhost:3000
SMB_API_KEY=your-api-key
```

## Usage

### With Claude Desktop

Add to your Claude Desktop config (`~/.claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "smb-platform": {
      "command": "node",
      "args": ["/path/to/binelekv2-mcp-server/build/index.js"],
      "env": {
        "SMB_API_URL": "http://localhost:3000",
        "SMB_API_KEY": "your-api-key"
      }
    }
  }
}
```

### Development

```bash
npm run dev
```

## Available Tools

| Tool | Description |
|------|-------------|
| `smb_query` | Query data using natural language |
| `smb_create_task` | Create a new task |
| `smb_list_tasks` | List tasks with filters |
| `smb_get_connectors` | Get connected services |
| `smb_get_dashboard` | Get dashboard data |
| `smb_get_security_status` | Get security posture |

## Structure

```
src/
├── index.ts       # MCP server entry point
├── client.ts      # API client for SMB platform
└── tools/         # Tool implementations
```

## Related Repositories

- [binelekv2-smb-platform-backend](https://github.com/k5tuck/binelekv2-smb-platform-backend)
- [binelekv2-smb-platform-frontend](https://github.com/k5tuck/binelekv2-smb-platform-frontend)
- [binelekv2-docs](https://github.com/k5tuck/binelekv2-docs)

## License

MIT