开源MCP工具

Prerequisites

• OS: Windows 11 or newer
• STAAD.Pro 2025 or newer installed and running

3. Install in editable mode with dev dependencies

pip install -e ".[dev]"

Integration tests (requires a running STAAD.Pro instance on Windows)

pytest -m integration -v ```

Development Setup

7. Building the MCPB Bundler

1. To produce the standalone .exe files distributed via the installer:

  pip install -e ".[build]"
  pyinstaller mcpb/openstaad-mcp.spec --noconfirm
  

This creates one file in the dist/ directory:

• openstaad-mcp.exe: console executable (stdio & http transport)

1. To create the .mcpb installer bundle, run:

  npm install -g @anthropic-ai/mcpb
  New-Item -ItemType Directory -Path mcpb-staging -Force
  Copy-Item dist/openstaad-mcp.exe mcpb-staging/

  $version = (Select-String -Path pyproject.toml -Pattern '^version\s*=\s*"(.+)"$').Matches[0].Groups[1].Value
  $manifest = Get-Content mcpb/manifest.json -Raw | ConvertFrom-Json
  $manifest.version = $version
  $manifest | ConvertTo-Json -Depth 10 | Set-Content mcpb-staging/manifest.json -Encoding utf8

  mcpb pack mcpb-staging/ openstaad-mcp.mcpb
  

The output MCPB bundle is written to .\openstaad-mcp.mcpb.

Quick Start with Claude Desktop (<2min)

1. Download the latest openstaad-mcp.mcpb file from the GitHub Releases page.
2. Open Claude Desktop.
3. Click the ☰ menu (top-left) → File → Settings → Extensions.
4. Click Advanced → Install Extensions.
5. Select the downloaded .mcpb file.
6. Click the ☰ menu (top-left) → File → Exit
7. Restart Claude Desktop.

Claude Desktop will install the server automatically. Open a new conversation and ask Claude to interact with your STAAD.Pro model.

Tip: Make sure STAAD.Pro is running with a model open before you start chatting.

---

Other Clients & Configuration

TL;DR:

If not already installed, install uv with the command:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Configure your client to start the server in stdio mode with the command:

uvx --from git+https://github.com/BentleySystems/openstaad-mcp openstaad-mcp

Claude Desktop (manual configuration)

If you prefer manual setup over the .mcpb bundle, edit the Claude Desktop config file directly:

• Windows (MSIX): %LOCALAPPDATA%\Packages\Claude_<id>\LocalCache\Roaming\Claude\claude_desktop_config.json
• Windows (classic): %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "openstaad": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/BentleySystems/openstaad-mcp", "openstaad-mcp"]
    }
  }
}

CLI Options

---

2. Create a virtual environment

```powershell python -m venv .venv

VS Code with GitHub Copilot

- For stdio: Open the Command Palette → MCP: Add Server... → Command (stdio) and enter the following command:

  uvx --from git+https://github.com/BentleySystems/openstaad-mcp openstaad-mcp
  

- For http: First, start the server in a terminal:

  uvx --from git+https://github.com/BentleySystems/openstaad-mcp openstaad-mcp --transport http
  

  WARNING: No --token provided. Auto-generated token: abc123def456ghi789jkl012mno345pq
  INFO:  Starting MCP server 'OpenSTAAD MCP' with transport 'http' (stateless) on http://127.0.0.1:18120/mcp
  

Then, in VS Code, open the Command Palette → MCP: Add Server... → HTTP URL and enter the URL shown in the terminal (e.g. http://127.0.0.1:18120/mcp). 18120 is the default port, but yours may differ if you have multiple instances running or if you changed the default. Add the header Authorization: Bearer <token> with the token shown in the MCP server terminal.