help ``` You should see the help text. **That's it** — no `pip install` needed. `uvx` downloads and runs the package automatically in an isolated environment. ### Step 3 — Add to your MCP client Pick your client and add the configuration below. **No other steps are required.** #### Claude Desktop Open the config file: - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` Add `mcsa` inside the `mcpServers` object (create the file if it doesn't exist): ```json { "mcpServers": { "mcsa": { "command": "uvx", "args": ["mcp-server-mcsa"] } } } ``` Then **restart Claude Desktop**. #### VS Code (Copilot / Continue) Create (or edit) `.vscode/mcp.json` in your workspace: ```json { "servers": { "mcsa": { "command": "uvx", "args": ["mcp-server-mcsa"] } } } ``` #### Cursor Go to **Settings → MCP Servers → Add new server**: - Type: `command` - Command: `uvx mcp-server-mcsa` ### Step 4 — Test In your MCP client, try: > "Generate a test signal with a broken rotor bar fault and run a full diagnosis. Motor: 4 poles, 50 Hz, 1470 RPM." If the server responds with a diagnostic report, you're all set. ---

Alternative: install with pip (not recommended — see note)

```bash pip install mcp-server-mcsa ``` Then configure your client with: ```json { "mcpServers": { "mcsa": { "command": "python", "args": ["-m", "mcp_server_mcsa"] } } } ``` > **⚠️ Common issue on Windows**: if you installed Python from the Microsoft Store, the `mcp-server-mcsa` command may not be in your PATH, causing a "server disconnected" error. In that case, find your Python path with `python -c "import sys; print(sys.executable)"` and use the full path in the config: > > ```json > { > "mcpServers": { > "mcsa": { > "command": "C:/Users/YOU/AppData/Local/.../python.exe", > "args": ["-m", "mcp_server_mcsa"] > } > } > } > ``` > > Using `uvx` avoids this problem entirely.

Alternative: install from source (for development)

```bash git clone https://github.com/LGDiMaggio/mcp-motor-current-signature-analysis.git cd mcp-motor-current-signature-analysis uv sync --dev ``` Configure the client to point to the local repo: ```json { "mcpServers": { "mcsa": { "command": "uv", "args": ["--directory", "/absolute/path/to/mcp-motor-current-signature-analysis", "run", "mcp-server-mcsa"] } } } ``` Run tests: ```bash uv run pytest ``` Debug with MCP Inspector: ```bash uv run mcp dev src/mcp_server_mcsa/server.py ```

### Troubleshooting | Problem | Fix | |---------|-----| | "server disconnected" on Claude Desktop | Check the logs at `%APPDATA%\Claude\logs\` (Windows) or `~/Library/Logs/Claude/` (macOS). Most common cause: the command in the config is not found. Use `uvx` to avoid PATH issues. | | `uvx: command not found` | Restart your terminal after installing uv. On Windows, you may need to close and reopen PowerShell. | | `mcp-server-mcsa: command not found` (pip) | The script wasn't added to PATH. Use `python -m mcp_server_mcsa` instead, or switch to `uvx`. | | Server starts but tools don't appear | Make sure you restarted the MCP client after editing the config. | ## Data Store Signals and spectra are **persisted to disk** as compressed `.npz` files in `~/.mcsa_data/` (configurable via the `MCSA_DATA_DIR` environment variable). This means: - **Large arrays never enter the chat** — only short IDs (`sig_xxxx`, `spec_xxxx`) and compact summaries are returned to the LLM. - **Data survives server restarts** — reopen Claude Desktop tomorrow and your signals are still there. - **All data in one place** — loaded measurements and generated test signals live side by side in the same folder. ``` ~/.mcsa_data/ signals/ sig_a1b2c3d4.npz ← loaded from CSV sig_e5f6g7h8.npz ← generated test signal spectra/ s

Mcp Motor Current Signature Analysis

Comments