# JDS6600 MCP Server for Sony TC-FX44 Repair

This project provides an MCP (Model Context Protocol) interface for the JDS6600 Signal Generator, specifically tailored for vintage tape recorder calibration and repair.

## Features
* **Auto-detection**: Automatically finds the CH340 chipset on COM ports.
* **Advanced Control**: Frequency, Amplitude, Waveform, DC Offset, Duty Cycle, and Phase shift.
* **Safety Defaults**: Returns to low-voltage sine wave on shutdown.
* **MCP Integration**: Control your lab hardware directly from Claude Desktop.

## Installation

1. **Create a virtual environment:**
```powershell
python -m venv .venv
.venv\Scripts\activate
```

2. **Install dependencies:**
```powershell
pip install fastmcp pyserial
```

## Usage

### Testing the hardware
To verify the connection and all advanced features (Offset, Duty, Phase), run the physical test from the project root:
```powershell
python tests/physical_test.py
```

### Running the MCP Server
o use it with Claude Desktop, add the server to your `claude_desktop_config.json`. 
**Note:** Replace `<YOUR_PROJECT_PATH>` with the actual absolute path to your folder.
```json
{
  "mcpServers": {
    "jds6600": {
      "command": "<YOUR_PROJECT_PATH>\\.venv\\Scripts\\python.exe",
      "args": [
        "<YOUR_PROJECT_PATH>\\src\\jds6600_mcp\\server.py"
      ]
    }
  }
}
```

## Credits
This driver's communication protocol and register logic are based on the extensive research and library by **Kristoff Bonne (on1arf)**.
* Original Repository: [on1arf/jds6600_python](https://github.com/on1arf/jds6600_python/)
* License: MIT