keyshot-mcp 1.1.0__tar.gz

keyshot_mcp-1.1.0/.gitignore

@@ -0,0 +1,18 @@
+libs/
+sorties/
+pyinstxtractor-master/
+refs/
+keyshot_files/
+.claude/settings.local.json
+__pycache__/
+*.pyc
+PLAN.md
+REPRISE.md
+RECHERCHE.md
+phase2/
+PREPARATION-MATERIAUX.md
+dev-plugin/
+.attic/
+dist/
+build/
+*.egg-info/

keyshot_mcp-1.1.0/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Changelog
+
+All important changes to this project are in this file.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+The project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+The bridge, the stop script and the MCP server have the same version.
+
+## [Unreleased]
+
+## [1.1.0] - 2026-10-24
+
+### Added
+
+- README: status "prototype" (badge, note at the top, section *Status*).
+- Issue templates *Bug* and *Feedback*. Questions go to the Discussions, security problems to a private report.
+- Pull request template with a *Failing first* section; CONTRIBUTING explains the rule.
+- `tests/mutations_pont.py`: disables each safety rule of the bridge in a temporary copy and checks that a test fails.
+- Tests for two safety rules that no test covered: a peer that is not `127.0.0.1` is closed without a reply; a library folder that is a link outside the library is refused.
+- README: demo GIF (`docs/demo.gif`).
+- A Python package for PyPI (`pyproject.toml`), with the command `keyshot-mcp`: without argument it starts the MCP server, `install-addin [--dir D]` copies the bridge scripts into the KeyShot Scripts folder (installed, updated or unchanged), `--version` prints the version. `run.py` and the release zip do not change.
+- Workflow *TestPyPI*: a manual rehearsal of the PyPI publication on test.pypi.org, with the version `X.Y.Z.dev<run id>` (`tools/dev_version.py`, tested by `tests/test_dev_version.py`), then an install from TestPyPI on Windows.
+- Claude Code plugin `keyshot` in `plugin/`, with the marketplace `.claude-plugin/marketplace.json`: the server through `uvx keyshot-mcp==<version>`, and the command `/keyshot-install-addin`. `tests/test_plugin.py` checks that the plugin, the server and the command use the version of the package.
+- `server.json` for the MCP registry (`io.github.lfoletti/keyshot-mcp`), and the line `mcp-name` in the README. After the publication to PyPI, the release workflow publishes `server.json` to the registry. `tests/test_publication.py` checks the name, the description length, the versions and the PyPI package.
+- GitHub Actions: the package is built, installed in a clean environment and run on Windows. On a tag, the sdist and the wheel go to the release, and to PyPI when the variable `PYPI_PUBLISH` is `true`.
+
+### Changed
+
+- `test_pont.py` runs outside Windows: the real-timer test is skipped there, and the test bench waits for the bridge to accept the connection and to receive the bytes instead of assuming the loopback is synchronous.
+
+## [1.0.0] - 2026-10-19
+
+First stable version. The bridge, the stop script and the MCP server now have the same version.
+
+### Added
+
+- GitHub Actions: the tests run on Windows for each pull request and each push to `main`.
+- GitHub Actions: Claude reviews each pull request and writes comments.
+- MCP prompt `keyshot_materiaux`: method to make materials from a CMF sheet or a description.
+- README: the project is not affiliated with Luxion or KeyShot.
+- `SECURITY.md`: how to report a vulnerability in private.
+- Dependabot keeps the GitHub Actions up to date. The actions are pinned to a commit SHA.
+- CONTRIBUTING: `main` is protected. Each change goes through a pull request.
+- Material names cannot contain `/`, `\`, `:`, `*`, `?`, `"`, `<`, `>`, `|` or `..` (a name is also a file name in the library).
+- Tool `save_material_to_library`: saves a material made by the bridge to a subfolder of the KeyShot library, with its CMF fields (Name, Color, Finish, Material, Vendor, Notes).
+- Tool `set_visibility`: shows or hides parts.
+- `fit_camera`: `force=true` replaces a camera view that is not saved.
+- Texture images: the bridge accepts a path only in KeyShot's texture library, in `dossier_sorties` or in the new setting `dossiers_textures`. It refuses network paths.
+
+### Changed
+
+- GitHub Actions: `actions/checkout` 7.0.1 and `actions/setup-python` 7.0.0.
+- The Claude review does not run on Dependabot pull requests.
+- `set_material_parameter`: without `node_id`, the bridge also looks for the parameter on the shader node (the node on `surface`).
+- Prompt `keyshot_materiaux`: values checked in KeyShot 2026.2 (library bases by finish, short roughness scale, metal color mode).
+- A `#RRGGBB` color is sRGB. The bridge changes it to linear. Before, the bridge used it as linear and the color was too light. Scripts that send `#RRGGBB` now get darker, correct values.
+
+### Fixed
+
+- `run.py` finds pywin32 in `libs` when Python starts with `-S`.
+- The bridge sees KeyShot primitives (Sphere, Cube…): groups without children that have a material.
+
+## [0.3.1] - 2026-10-19
+
+### Changed
+
+- The KeyShot scripts have new names: `MCP start.py` (bridge) and `MCP stop.py`.
+- The script author is "atelier oï".
+
+## [0.3.0] - 2026-10-19
+
+First public version.
+
+### Added
+
+- MCP server `keyshotmcp` 0.1.0 with 31 tools: scene, cameras, environments, materials, material graph, renders and bridge.
+- Bridge in KeyShot. It listens on 127.0.0.1:1998 and each request must have a token.
+- Settings file `%LOCALAPPDATA%\keyshot-mcp\pont-config.json`.
+- Environment variables `KEYSHOT_MCP_PORT`, `KEYSHOT_MCP_TIMEOUT`, `KEYSHOT_MCP_EXECUTE_PYTHON` and `KEYSHOT_MCP_PYTHON` (tests).
+- Tests without KeyShot: 72 bridge tests and 9 end-to-end tests.
+- README, CONTRIBUTING and MIT license.
+
+### Security
+
+- `execute_python` is off. Only a local setting can enable it.
+- The tools edit a material graph only on copies that the bridge made.
+- `save_scene` keeps a copy of the old `.bip` file.
+
+[Unreleased]: https://github.com/lfoletti/keyshot-mcp/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/lfoletti/keyshot-mcp/releases/tag/v1.1.0
+[1.0.0]: https://github.com/lfoletti/keyshot-mcp/releases/tag/v1.0.0
+[0.3.1]: https://github.com/lfoletti/keyshot-mcp/commit/bb801b8
+[0.3.0]: https://github.com/lfoletti/keyshot-mcp/commit/2a654b0

keyshot_mcp-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lauro Foletti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

keyshot_mcp-1.1.0/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: keyshot-mcp
+Version: 1.1.0
+Summary: MCP server: control KeyShot Studio from Claude Code (scene, cameras, materials from a CMF sheet, renders)
+Project-URL: Homepage, https://github.com/lfoletti/keyshot-mcp
+Project-URL: Issues, https://github.com/lfoletti/keyshot-mcp/issues
+Project-URL: Changelog, https://github.com/lfoletti/keyshot-mcp/blob/main/CHANGELOG.md
+Author: Lauro Foletti
+License-Expression: MIT
+License-File: LICENSE
+Keywords: 3d-rendering,claude-code,keyshot,mcp,model-context-protocol
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
+Requires-Python: >=3.12
+Requires-Dist: mcp==1.28.1
+Description-Content-Type: text/markdown
+
+# keyshot-mcp
+
+<!-- mcp-name: io.github.lfoletti/keyshot-mcp -->
+
+Control an open KeyShot Studio 2026 window from Claude Code with the Model Context Protocol (MCP).
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Status: prototype](https://img.shields.io/badge/status-prototype-orange.svg)](#status)
+[![Tests](https://github.com/lfoletti/keyshot-mcp/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/lfoletti/keyshot-mcp/actions/workflows/tests.yml)
+[![Release](https://img.shields.io/github/v/release/lfoletti/keyshot-mcp)](https://github.com/lfoletti/keyshot-mcp/releases)
+
+> **Status: prototype.** The tools work and have tests, but the project depends on the scripting API of KeyShot, which can change. Tell us what you use and what fails: open an issue or a discussion.
+
+![Claude Code reads the KeyShot scene, changes the bottle glass three times, then undoes all the changes.](docs/demo.gif)
+
+*The demo plays 3 times faster than real time.*
+
+```
+Claude Code ⇄ MCP server keyshotmcp (Python 3.12, stdio)
+            ⇄ TCP 127.0.0.1:1998, 4-byte length + JSON, token
+            ⇄ MCP start.py (in KeyShot, timer on the UI thread)
+```
+
+The bridge runs inside KeyShot. The server runs in Claude Code. They speak only on the local computer.
+
+## Requirements
+
+| Item | Version |
+|---|---|
+| KeyShot Studio | 15.1 (2026) or later. Tested with 2026.2 Pro (15.1.2.7). |
+| Python | 3.12 or later, Windows |
+| `mcp` | 1.28.1 |
+| Claude Code | any recent version |
+
+## Install
+
+### From PyPI
+
+From version 1.1.0, `keyshot-mcp` is a Python package. With [uv](https://docs.astral.sh/uv/):
+
+```
+uvx keyshot-mcp install-addin
+claude mcp add keyshot -- uvx keyshot-mcp
+```
+
+`install-addin` copies the two bridge scripts into `%PUBLIC%\Documents\KeyShot Studio\Scripts` (or the folder of `--dir`). Then restart KeyShot.
+
+### As a Claude Code plugin
+
+From version 1.1.0, this repository is also a Claude Code marketplace. The plugin `keyshot` starts the server with `uvx`, so [uv](https://docs.astral.sh/uv/) must be installed.
+
+```
+/plugin marketplace add lfoletti/keyshot-mcp
+/plugin install keyshot@keyshot-mcp
+```
+
+Then run `/keyshot-install-addin` once, and restart KeyShot.
+
+### From the release zip or the repository
+
+Each release has `keyshot-mcp-<version>-windows.zip`, with `libs/` already filled. Unzip it, then go to step 3. Without the zip, start at step 1.
+
+1. Clone the repository:
+   ```
+   git clone https://github.com/lfoletti/keyshot-mcp.git
+   ```
+2. Install `mcp` in the `libs` folder. `run.py` loads it from there.
+   ```
+   py -3.12 -m pip install --target libs mcp==1.28.1
+   ```
+3. Copy `addin\Scripts\MCP start.py` and `MCP stop.py` to
+   `C:\Users\Public\Documents\KeyShot Studio\Scripts\`.
+4. Restart KeyShot. KeyShot reads the Scripts folder only when it starts.
+5. Add the server to Claude Code:
+   ```
+   claude mcp add keyshot -- py -3.12 -I -S C:\path\to\keyshot-mcp\run.py
+   ```
+6. Make sure the imports are correct:
+   ```
+   py -3.12 -I -S run.py --check
+   ```
+   The output shows `keyshot : imports ok` and 33 tools.
+
+## Use
+
+1. In KeyShot, open *Window > Scripting Console > Scripts*.
+2. Select `MCP start`, then click *Run*. The console shows `Pont KeyShot actif sur 127.0.0.1:1998`.
+3. In Claude Code, type `/mcp`. Make sure that `keyshot` is connected.
+4. Ask Claude, for example:
+   - "Show me the scene and list the materials."
+   - "Apply brushed aluminium to the cap, then make a 1920 × 1080 render."
+
+To stop the bridge, run the script `MCP stop`, or close KeyShot.
+To update the bridge, copy the new file, then use the tool `reload_bridge`.
+
+## Tools
+
+| Group | Tools |
+|---|---|
+| Scene | `keyshot_status`, `get_scene_info`, `get_scene_tree`, `list_objects`, `set_visibility`, `screenshot`, `save_scene` |
+| Cameras and environment | `list_cameras`, `set_camera`, `fit_camera`, `list_environments`, `set_environment`, `set_realtime` |
+| Materials | `list_materials`, `get_material`, `list_library_materials`, `assign_material`, `set_material_parameter`, `rename_material`, `undo_material_changes`, `commit_material_changes`, `save_material_to_library` |
+| Material graph | `add_material_node`, `connect_material_nodes`, `disconnect_material_input`, `remove_material_node` |
+| Render | `render_image`, `render_status`, `wait_for_render`, `view_image` |
+| Bridge | `lux_functions`, `reload_bridge`, `execute_python` (off by default) |
+
+Two MCP prompts give Claude the method:
+
+| Prompt | Use |
+|---|---|
+| `keyshot_strategy` | How to work in KeyShot without damage to the scene. |
+| `keyshot_materiaux` | How to make materials from a CMF sheet (color, material, finish) or a description: physical values, colors, node recipes. |
+
+Colors: `[r, g, b]` is linear (0-1). `#RRGGBB` is sRGB: the bridge changes it to linear.
+
+## Settings
+
+Optional file: `%LOCALAPPDATA%\keyshot-mcp\pont-config.json`.
+
+```json
+{"execute_python": false, "dossier_sorties": "C:\\path\\to\\outputs"}
+```
+
+| Setting | Effect |
+|---|---|
+| `execute_python` | `true` enables the tool `execute_python`. The default is `false`. |
+| `dossier_sorties` | Folder for screenshots, renders and scene backups. |
+| `dossiers_textures` | List of more folders where the bridge can read texture images. KeyShot's texture library and `dossier_sorties` are always allowed. |
+| `KEYSHOT_MCP_PORT` | Environment variable. Bridge port. The default is 1998. |
+| `KEYSHOT_MCP_TIMEOUT` | Environment variable. Server timeout in seconds. The default is 60. |
+| `KEYSHOT_MCP_EXECUTE_PYTHON` | Environment variable. `1` enables `execute_python`. |
+
+The bridge writes `pont-actif.json` (port, token, KeyShot PID) and `pont.log` in the same folder.
+
+## Safety
+
+- The bridge listens only on 127.0.0.1. Each request must have the token from `pont-actif.json`.
+- `execute_python` is off. Only a local setting can enable it.
+- The tools edit a material graph only on copies that the bridge made.
+- `set_camera` does not discard a camera view that is not saved.
+- `save_scene` keeps a copy of the old `.bip` file.
+
+## Tests
+
+The tests use a fake `lux` module. KeyShot is not necessary.
+
+```
+cd tests
+py -3.13 test_pont.py
+py -3.13 test_serveur_mcp.py
+```
+
+`test_pont.py` has 85 tests for the bridge. `test_serveur_mcp.py` has 9 end-to-end tests. The `essai_*.py` files need an open KeyShot.
+
+`test_serveur_mcp.py` starts the server with the Python that runs the test. If the packages in `libs` are for a different Python version, set `KEYSHOT_MCP_PYTHON` to the applicable `python.exe`.
+
+## Contribute
+
+Read [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+## Status
+
+keyshot-mcp is a working prototype. It is tested with KeyShot Studio 2026.2 Pro on Windows.
+
+- The bridge uses the KeyShot scripting API (`lux`). A new KeyShot version can change this API.
+- KeyShot can add its own integration with Claude in a future version. This project can then stop.
+- Feedback has priority over new features. Use the issue templates *Bug* and *Feedback*.
+
+## Disclaimer
+
+keyshot-mcp is an independent project. It is not affiliated with Luxion or KeyShot, and so far Luxion does not endorse or sponsor it. KeyShot is a trademark of Luxion.
+
+## License
+
+MIT

keyshot_mcp-1.1.0/README.md

@@ -0,0 +1,175 @@
+# keyshot-mcp
+
+<!-- mcp-name: io.github.lfoletti/keyshot-mcp -->
+
+Control an open KeyShot Studio 2026 window from Claude Code with the Model Context Protocol (MCP).
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Status: prototype](https://img.shields.io/badge/status-prototype-orange.svg)](#status)
+[![Tests](https://github.com/lfoletti/keyshot-mcp/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/lfoletti/keyshot-mcp/actions/workflows/tests.yml)
+[![Release](https://img.shields.io/github/v/release/lfoletti/keyshot-mcp)](https://github.com/lfoletti/keyshot-mcp/releases)
+
+> **Status: prototype.** The tools work and have tests, but the project depends on the scripting API of KeyShot, which can change. Tell us what you use and what fails: open an issue or a discussion.
+
+![Claude Code reads the KeyShot scene, changes the bottle glass three times, then undoes all the changes.](docs/demo.gif)
+
+*The demo plays 3 times faster than real time.*
+
+```
+Claude Code ⇄ MCP server keyshotmcp (Python 3.12, stdio)
+            ⇄ TCP 127.0.0.1:1998, 4-byte length + JSON, token
+            ⇄ MCP start.py (in KeyShot, timer on the UI thread)
+```
+
+The bridge runs inside KeyShot. The server runs in Claude Code. They speak only on the local computer.
+
+## Requirements
+
+| Item | Version |
+|---|---|
+| KeyShot Studio | 15.1 (2026) or later. Tested with 2026.2 Pro (15.1.2.7). |
+| Python | 3.12 or later, Windows |
+| `mcp` | 1.28.1 |
+| Claude Code | any recent version |
+
+## Install
+
+### From PyPI
+
+From version 1.1.0, `keyshot-mcp` is a Python package. With [uv](https://docs.astral.sh/uv/):
+
+```
+uvx keyshot-mcp install-addin
+claude mcp add keyshot -- uvx keyshot-mcp
+```
+
+`install-addin` copies the two bridge scripts into `%PUBLIC%\Documents\KeyShot Studio\Scripts` (or the folder of `--dir`). Then restart KeyShot.
+
+### As a Claude Code plugin
+
+From version 1.1.0, this repository is also a Claude Code marketplace. The plugin `keyshot` starts the server with `uvx`, so [uv](https://docs.astral.sh/uv/) must be installed.
+
+```
+/plugin marketplace add lfoletti/keyshot-mcp
+/plugin install keyshot@keyshot-mcp
+```
+
+Then run `/keyshot-install-addin` once, and restart KeyShot.
+
+### From the release zip or the repository
+
+Each release has `keyshot-mcp-<version>-windows.zip`, with `libs/` already filled. Unzip it, then go to step 3. Without the zip, start at step 1.
+
+1. Clone the repository:
+   ```
+   git clone https://github.com/lfoletti/keyshot-mcp.git
+   ```
+2. Install `mcp` in the `libs` folder. `run.py` loads it from there.
+   ```
+   py -3.12 -m pip install --target libs mcp==1.28.1
+   ```
+3. Copy `addin\Scripts\MCP start.py` and `MCP stop.py` to
+   `C:\Users\Public\Documents\KeyShot Studio\Scripts\`.
+4. Restart KeyShot. KeyShot reads the Scripts folder only when it starts.
+5. Add the server to Claude Code:
+   ```
+   claude mcp add keyshot -- py -3.12 -I -S C:\path\to\keyshot-mcp\run.py
+   ```
+6. Make sure the imports are correct:
+   ```
+   py -3.12 -I -S run.py --check
+   ```
+   The output shows `keyshot : imports ok` and 33 tools.
+
+## Use
+
+1. In KeyShot, open *Window > Scripting Console > Scripts*.
+2. Select `MCP start`, then click *Run*. The console shows `Pont KeyShot actif sur 127.0.0.1:1998`.
+3. In Claude Code, type `/mcp`. Make sure that `keyshot` is connected.
+4. Ask Claude, for example:
+   - "Show me the scene and list the materials."
+   - "Apply brushed aluminium to the cap, then make a 1920 × 1080 render."
+
+To stop the bridge, run the script `MCP stop`, or close KeyShot.
+To update the bridge, copy the new file, then use the tool `reload_bridge`.
+
+## Tools
+
+| Group | Tools |
+|---|---|
+| Scene | `keyshot_status`, `get_scene_info`, `get_scene_tree`, `list_objects`, `set_visibility`, `screenshot`, `save_scene` |
+| Cameras and environment | `list_cameras`, `set_camera`, `fit_camera`, `list_environments`, `set_environment`, `set_realtime` |
+| Materials | `list_materials`, `get_material`, `list_library_materials`, `assign_material`, `set_material_parameter`, `rename_material`, `undo_material_changes`, `commit_material_changes`, `save_material_to_library` |
+| Material graph | `add_material_node`, `connect_material_nodes`, `disconnect_material_input`, `remove_material_node` |
+| Render | `render_image`, `render_status`, `wait_for_render`, `view_image` |
+| Bridge | `lux_functions`, `reload_bridge`, `execute_python` (off by default) |
+
+Two MCP prompts give Claude the method:
+
+| Prompt | Use |
+|---|---|
+| `keyshot_strategy` | How to work in KeyShot without damage to the scene. |
+| `keyshot_materiaux` | How to make materials from a CMF sheet (color, material, finish) or a description: physical values, colors, node recipes. |
+
+Colors: `[r, g, b]` is linear (0-1). `#RRGGBB` is sRGB: the bridge changes it to linear.
+
+## Settings
+
+Optional file: `%LOCALAPPDATA%\keyshot-mcp\pont-config.json`.
+
+```json
+{"execute_python": false, "dossier_sorties": "C:\\path\\to\\outputs"}
+```
+
+| Setting | Effect |
+|---|---|
+| `execute_python` | `true` enables the tool `execute_python`. The default is `false`. |
+| `dossier_sorties` | Folder for screenshots, renders and scene backups. |
+| `dossiers_textures` | List of more folders where the bridge can read texture images. KeyShot's texture library and `dossier_sorties` are always allowed. |
+| `KEYSHOT_MCP_PORT` | Environment variable. Bridge port. The default is 1998. |
+| `KEYSHOT_MCP_TIMEOUT` | Environment variable. Server timeout in seconds. The default is 60. |
+| `KEYSHOT_MCP_EXECUTE_PYTHON` | Environment variable. `1` enables `execute_python`. |
+
+The bridge writes `pont-actif.json` (port, token, KeyShot PID) and `pont.log` in the same folder.
+
+## Safety
+
+- The bridge listens only on 127.0.0.1. Each request must have the token from `pont-actif.json`.
+- `execute_python` is off. Only a local setting can enable it.
+- The tools edit a material graph only on copies that the bridge made.
+- `set_camera` does not discard a camera view that is not saved.
+- `save_scene` keeps a copy of the old `.bip` file.
+
+## Tests
+
+The tests use a fake `lux` module. KeyShot is not necessary.
+
+```
+cd tests
+py -3.13 test_pont.py
+py -3.13 test_serveur_mcp.py
+```
+
+`test_pont.py` has 85 tests for the bridge. `test_serveur_mcp.py` has 9 end-to-end tests. The `essai_*.py` files need an open KeyShot.
+
+`test_serveur_mcp.py` starts the server with the Python that runs the test. If the packages in `libs` are for a different Python version, set `KEYSHOT_MCP_PYTHON` to the applicable `python.exe`.
+
+## Contribute
+
+Read [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).
+
+## Status
+
+keyshot-mcp is a working prototype. It is tested with KeyShot Studio 2026.2 Pro on Windows.
+
+- The bridge uses the KeyShot scripting API (`lux`). A new KeyShot version can change this API.
+- KeyShot can add its own integration with Claude in a future version. This project can then stop.
+- Feedback has priority over new features. Use the issue templates *Bug* and *Feedback*.
+
+## Disclaimer
+
+keyshot-mcp is an independent project. It is not affiliated with Luxion or KeyShot, and so far Luxion does not endorse or sponsor it. KeyShot is a trademark of Luxion.
+
+## License
+
+MIT