Feature/configurable port

[MasayukiOsaka]

Description

This PR adds the ability to configure the port number for the MCP server, allowing users to run multiple instances or avoid port conflicts.

Changes

• Added port parameter to start_server() and initialize_plugin() functions in __init__.py
• Added --port command line argument to houdini_mcp_server.py
• Updated inline documentation for the new functionality
• Updated README.md with port configuration examples

Usage Examples

Houdini side

import houdinimcp

# Start with default port (9876)
houdinimcp.start_server()

# Start with custom port
houdinimcp.start_server(8080)

# Auto-start on Houdini launch (in pythonrc.py)
houdinimcp.initialize_plugin(port=8888)

Claude Desktop configuration

{
  "mcpServers": {
    "houdini": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/houdinimcp",
        "houdini_mcp_server.py",
        "--port",
        "8080"
      ]
    }
  }
}

Testing

• ✅ Tested with default port (9876)
• ✅ Tested with custom ports (8080, 8888)
• ✅ Tested auto-start via pythonrc.py
• ✅ Tested manual start via UI/shelf tools
• ✅ Backward compatibility confirmed

Notes

• This change maintains full backward compatibility
• Updated README.md with port configuration examples
• Future enhancement: Environment variable support (planned for separate PR)