Skip to main content

MCP server that places and wires Wasp discrete-aggregation components on a live Grasshopper canvas (bridge: GH_MCP_Wasp / wasp-mcp-bridge on Yak, TCP localhost, default port 8090, optional WASP_MCP_TOKEN auth per PROTOCOL v0.5)

Project description

wasp-mcp-server

MCP server that lets Claude (or any MCP client) drive Wasp discrete aggregation — and general Grasshopper work — on a live Grasshopper canvas: place and wire components, set sliders/panels/toggles, run aggregations with seeds and fields, read outputs, capture the canvas and viewport, and bake results into Rhino.

Generation is knowledge-guided: parameter aliases, wiring topology, and staged templates distilled from the Wasp example corpus ship with the package (knowledge/, see LICENSE-KNOWLEDGE.md), so the model composes canonical Wasp workflows instead of guessing wire routes.

Setup

You need Rhino 8 for Windows with Grasshopper, and Wasp installed for the aggregation workflows.

  1. Bridge — in Rhino 8 run _PackageManager, search wasp-mcp-bridge, install. Open Grasshopper and drop the WaspMCP component on the canvas; it listens on 127.0.0.1:8090 (local only).

  2. Server — with uv installed (winget install astral-sh.uv), register with Claude:

    {
      "mcpServers": {
        "WaspMCP": {
          "command": "uvx",
          "args": ["wasp-mcp-server"]
        }
      }
    }
    

    (Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json; Claude Code: claude mcp add WaspMCP -- uvx wasp-mcp-server.)

  3. Restart Claude with Grasshopper open and the WaspMCP component on the canvas. Optional shared-secret auth: set the component's Token input and the WASP_MCP_TOKEN environment variable to the same value.

Full protocol, cookbook, and tool reference: https://github.com/liangjunglj-cpu/wasp-mcp

What ships here

Only self-authored code and knowledge derived as factual observations from openly licensed examples. Wasp itself (LGPL-3.0) is not bundled — the bridge instantiates your locally installed Wasp UserObjects at runtime. See THIRD-PARTY-NOTICES.md.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wasp_mcp_server-0.5.2.tar.gz (225.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

wasp_mcp_server-0.5.2-py3-none-any.whl (126.7 kB view details)

Uploaded Python 3

File details

Details for the file wasp_mcp_server-0.5.2.tar.gz.

File metadata

  • Download URL: wasp_mcp_server-0.5.2.tar.gz
  • Upload date:
  • Size: 225.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for wasp_mcp_server-0.5.2.tar.gz
Algorithm Hash digest
SHA256 9c69a372f51c0bdd81c15c23f81f07940c2e4e622dbbadf9f1b3fd3d754efde6
MD5 1f129899bacb5d73aac14a905292a4f0
BLAKE2b-256 d6cad5445b9983cd0cb4da69de6b21a68222e6754d2b919a7c7ebe297376fc8f

See more details on using hashes here.

File details

Details for the file wasp_mcp_server-0.5.2-py3-none-any.whl.

File metadata

  • Download URL: wasp_mcp_server-0.5.2-py3-none-any.whl
  • Upload date:
  • Size: 126.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.11.23 {"installer":{"name":"uv","version":"0.11.23","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for wasp_mcp_server-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6929933fb0dcc5eaf20ddcbdf62f3b4aeec8c870982a10956234989dcf165f16
MD5 847bfb8dcf89be842e3c4fc6d1832def
BLAKE2b-256 e143990b80fcbfac10c79f86331c59a876ecba656e5934a5c698edf465655a3d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page