Hoops Ai Mcpserver — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Hoops Ai Mcpserver (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
An MCP (Model Context Protocol) server that bridges Claude Desktop to the HOOPS AI WebAPI. With this server registered in Claude Desktop, users can perform 3D CAD analysis through natural language — no code required. See the root README for an overview of the full platform.
uv to launch the MCP server process)http://127.0.0.1:8000)→ See webapi/README.md for setup instructions
claude_desktop_config.json. Add the following entry under mcpServers:{
"mcpServers": {
"hoops-ai": {
"command": "uv",
"args": [
"run",
"--directory",
"C:\\path\\to\\HOOPS_AI-MCP\\mcp_server",
"server.py"
]
}
}
}Replace C:\\path\\to\\HOOPS_AI-MCP with the actual path where you cloned this repository.Troubleshooting — `uv` not found: Claude Desktop launches with a limited PATH and may fail to finduveven if it works in your terminal. If the MCP server does not appear in Claude Desktop, use the full path touv.exeinstead of"uv": ``powershell where.exe uv # find the full path, e.g. C:\Users\<you>\.local\bin\uv.exe`Then update"command"in the config:`json "command": "C:\\Users\\<you>\\.local\\bin\\uv.exe"``
Same machine (default):
No additional configuration is needed. The MCP server defaults to http://127.0.0.1:8000, so if the WebAPI server is running on the same machine, the basic config above works as-is.
When the WebAPI server is on a different machine (client-server setup):
Add "env": {"HOOPS_WEBAPI_URL": "..."} to the config — no system environment variable is needed. Claude Desktop passes this value to the MCP server process automatically:
{
"mcpServers": {
"hoops-ai": {
"command": "uv",
"args": [
"run",
"--directory",
"C:\\path\\to\\HOOPS_AI-MCP\\mcp_server",
"server.py"
],
"env": {
"HOOPS_WEBAPI_URL": "http://192.168.0.6:8000"
}
}
}
}Replace 192.168.0.6 with the actual IP address of the machine running the WebAPI server. This is the only configuration change needed on the client machine.Claude Desktop can call these 12 tools using natural language:
| Tool | Description |
|---|---|
upload_cad_model | Upload a local CAD file to the server. Returns file_id, filename, and already_existed. Pass file_id to other tools to avoid re-uploading. |
open_cad_viewer | Open a CAD file in the interactive 3D browser viewer. Returns viewer_url and image_url (PNG preview). |
terminate_CAD_viewer | Terminate the last active viewer, or all viewers (terminate_all=True). |
get_brep_adjacency_graph | Build a face adjacency graph from a CAD file. Returns graph data (nodes, edges, counts) and image_url (PNG visualization URL). |
get_brep_attributes | Extract face and edge attributes (types, areas, lengths, dihedral angles, etc.) from a CAD file. |
get_MFR_table_of_contents | Get a summary of the Manufacturing Feature Recognition (MFR) dataset. |
get_MFR_labels_description | List all MFR label IDs, feature names, and descriptions. |
search_MFR_files | Find CAD files in the MFR dataset that contain a given manufacturing feature. |
get_MFR_file_thumbnail | Return the URL of the thumbnail PNG for a given dataset file ID. |
run_MFR_inference | Run MFR inference on a CAD file. Launches the viewer and returns predictions, probabilities, viewer_url, and image_url (PNG preview). |
search_similar_shapes | Find the top-k most similar parts using HOOPS Embeddings and a FAISS index. Returns match IDs, similarity scores, and image_url (result grid image URL). |
get_similar_part_image | Return the URL of the pre-generated PNG thumbnail for a part filename returned by search_similar_shapes. |
Once the MCP server is registered and the WebAPI server is running, you can chat with Claude:
What HOOPS AI tools are available?"C:\temp\helloworld.stp" — please display this 3D CAD file."C:\temp\Flange287.stp" — show this model and give me its B-Rep information.Tell me about the manufacturing feature recognition dataset."C:\temp\nist_ftc_06_asme1_rd_sw1802.SLDPRT" — run manufacturing feature recognition and colorize by feature type."C:\temp\idler_sprocket.step" — search for similar parts to this component.~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.