site-mcp-servers

# Offline MCP tools

Two small MCP servers for music timing and Tesla wrap preparation. Every tool
runs locally using arithmetic or bundled reference data. No API key, account,
network request, telemetry or website backend connection is required.

## Voice To Instrument — Music Utilities

From [Voice To Instrument](https://voicetoinstrument.com/).

- `tempo_to_timing`: quarter-note BPM to note durations and bar length.
- `note_to_frequency`: scientific pitch notation to Hz and MIDI number.
- `frequency_to_note`: nearest equal-tempered note and cents deviation.

For example, 120 BPM gives a 500 ms quarter note, a 375 ms dotted eighth and
an 8-second four-bar phrase in 4/4. A4 is 440 Hz with the default tuning.
This package performs music calculations; it does not generate or convert audio.

## Tesla Wrap Generator — Template Utilities

From [Tesla Wrap Generator](https://teslawrapgenerator.com/).

- `list_vehicle_templates`: filter 12 bundled model/trim templates by family.
- `validate_wrap_metadata`: check dimensions, filename and byte size supplied
  by the caller against the selected template.

The catalog references [Tesla's published templates](https://github.com/teslamotors/custom-wraps),
checked on October 17, 2026. The native Cybertruck template is 1024 × 768;
the other bundled templates are 1024 × 1024. Reference links are returned as
text and are never downloaded by the server. No template images are bundled.

Checks use conservative limits of 1,000,000 bytes and a 30-character filename
including `.png`. They check **supplied metadata only**, not file contents,
panel alignment or acceptance by a particular vehicle/software version.
This package does not generate wraps. It is not affiliated with Tesla, Inc.

## Install

Download the appropriate `.mcpb` file from [Releases](https://github.com/stark-ydq/site-mcp-servers/releases/latest)
and install it in a client supporting MCP bundles. Node.js 20.19+ is required.
No environment variables or credentials are needed.

For a client configured using JSON, extract the bundle (it is a ZIP archive)
and use the absolute path to its `server/index.cjs`:

```json
{
  "mcpServers": {
    "music-utilities": {
      "command": "node",
      "args": ["/absolute/path/to/extracted/voice/server/index.cjs"]
    },
    "wrap-utilities": {
      "command": "node",
      "args": ["/absolute/path/to/extracted/tesla/server/index.cjs"]
    }
  }
}
```

## Development

```sh
npm ci
npm test
npm run build
npm run smoke
```

The smoke test connects through the MCP client SDK and calls every tool in each
extracted bundle. On macOS the child servers run with OS-level network access
denied. Bundle hashes and Registry metadata are generated by the build.

Registry identifiers:

- `io.github.stark-ydq/voicetoinstrument`
- `io.github.stark-ydq/teslawrapgenerator`

License: MIT. Third-party dependency notices are included in each bundle.