# Sample Data MCP

A Model Context Protocol (MCP) server that generates fixed-length test data based on field specifications. This tool helps developers create realistic test datasets with customizable field types and formats.

## Features

- Generate fixed-length test data records
- Support for multiple field types:
  - `string`: Random names using Faker library
  - `enum`: Random selection from provided values
  - `integer`: Random integers within specified range
  - `date`: Random dates with customizable format
  - `filler`: Space padding fields
- Configurable field length and constraints
- MCP-compatible for integration with Claude Code

## Installation

### Prerequisites

- Python 3.13 or higher
- [UV package manager](https://docs.astral.sh/uv/)

### Install with UV

1. Clone or download this project
2. Navigate to the project directory
3. Install dependencies:
   ```bash
   uv sync
   ```

### Install into Claude Code

1. Add the MCP server to your Claude Code configuration. Edit your MCP settings file (typically `~/.config/claude-code/mcp_servers.json` or similar):

   ```json
   {
     "mcpServers": {
       "sample-data-mcp": {
         "command": "uv",
         "args": ["run", "/path/to/sample-data-mcp/main.py"],
         "cwd": "/path/to/sample-data-mcp"
       }
     }
   }
   ```

2. Restart Claude Code to load the new MCP server

## Usage

Once installed, you can use the `generate_test_data_tool` through Claude Code to create test data:

### Example Field Specification

```python
fields = [
    {
        "name": "customer_id",
        "type": "integer",
        "length": 8,
        "min": 1000,
        "max": 9999
    },
    {
        "name": "customer_name",
        "type": "string",
        "length": 25
    },
    {
        "name": "status",
        "type": "enum",
        "length": 6,
        "values": ["ACTIVE", "INACTIVE", "PENDING"]
    },
    {
        "name": "signup_date",
        "type": "date",
        "length": 8,
        "format": "%Y%m%d"
    },
    {
        "name": "filler",
        "type": "filler",
        "length": 5
    }
]
```

### Field Types

| Type | Description | Required Fields | Optional Fields |
|------|-------------|-----------------|-----------------|
| `string` | Random names | `name`, `type`, `length` | - |
| `enum` | Random selection from list | `name`, `type`, `length`, `values` | - |
| `integer` | Random integer | `name`, `type`, `length` | `min`, `max` |
| `date` | Random date | `name`, `type`, `length` | `format` |
| `filler` | Space padding | `name`, `type`, `length` | - |

## Development

### Testing Locally

```bash
uv run mcp dev main.py
```

### Dependencies

- `faker`: For generating realistic fake data
- `mcp`: Model Context Protocol implementation
- `pydantic`: Data validation and settings management

## License

This project is provided as-is for educational and development purposes.