3dspace

This MCP server converts OpenAPI specifications for 3DSpace into MCP tools, enabling you to interact with 3DSpace Engineering Web Services via MCP clients. It reads OpenAPI JSON files from the swagger_files/ folder and exposes a suite of tools that let you discover, authenticate, and execute API operations against 3DSpace services such as Engineering Items, Manufacturing Items, Change Management, Project Management, Document Management, and Requirements Management, among others. Core capabilities include executing specific API operations by operation ID, making direct HTTP requests, and searching for operations by keywords. You can also configure the base 3DSpace URL, retrieve available security contexts, and obtain CSRF tokens for state-changing actions. Use list_available_tools to explore all provided MCP tools and their descriptions, then leverage api_request and generic_api_call to perform requests programmatically. For testing in MCP clients, load the supplied prompt_3dspace.md as a system prompt to ensure proper authentication handling, security contexts, and accurate parameter naming, including any required $ prefixes.

Prerequisites:

• Python 3.8+
• pip installed and available in PATH

Installation steps:

1. Clone the repository or download the README and accompanying files to a working directory.
2. Install dependencies:

   pip install -r requirements.txt
   

3. Ensure the OpenAPI swagger files exist in the swagger_files/ directory (provided in the project).
4. (Optional) Normalize OpenAPI paths before running the server:

   python update_openapi_paths.py
   

5. Start the MCP server in SSE mode:

   python mcp_server.py --sse
   

   Or start in STDIO mode:

   python mcp_server.py --stdio
   

6. Connect your MCP client using the generated mcpServers configuration (see the README under MCP Client Configuration for examples).

Tips and common considerations:

• The server reads OpenAPI specs from swagger_files/ to generate MCP tools. Ensure those files are present and up to date.
• If you enable STDIO mode, you can launch the server as a child process from another application; the STDIO configuration example in the README demonstrates how to specify command and arguments.
• For secure interactions, configure 3DSpace base URL using set_3dspace_url and obtain a valid security context with get_security_context. Use get_csrf_token for operations that modify state.
• If you encounter issues with URL normalization, run update_openapi_paths.py to ensure consistent path structures across all specifications.
• The prompt_3dspace.md file is recommended as the system prompt when testing with MCP clients to ensure proper authentication handling and parameter naming conventions.
• This MCP server is Python-based; if you switch environments, ensure Python dependencies are installed from requirements.txt and that swagger_files/ contains all necessary OpenAPI specs.